Source: https://developers.woosmap.com/products/stores-api/guides/integration-path/

> For clean Markdown of any page, append `.md` to the page URL.

> For a complete documentation index, see https://developers.woosmap.com/llms.txt

# Choosing Your Stores API Integration



This guide helps you choose the right integration path for your project. Find your use case in the summary table below or jump to a specific section for details.

## Choose Your Integration Path

| If you're building...      | Use This                 | For...                                            |
| :------------------------- | :----------------------- | :------------------------------------------------ |
| A backend or data pipeline | **REST API**             | Full, platform-agnostic control.                  |
| A location-aware web app   | **Map JS API**           | The recommended, unified map and search solution. |
| A store finder page        | **Store Locator Widget** | The fastest setup with built-in UI.               |
| A native mobile app        | **Mobile SDKs**          | Native iOS and Android integration.               |

### 1. REST API

For any non-browser environment, the REST API is your starting point. It provides direct, platform-agnostic access to the Stores API engine.

- **Use it for:** Backend services, data processing, or mobile apps with custom HTTP clients.
- **Key benefit:** Full control with a secure, private API key.

**[Go to the REST API Quickstart](/products/stores-api/tutorials/making-first-request/)**

### 2. Map JS API (Recommended for Web)

The Map JS API includes the [`StoresService`](/products/map-api/reference/1.4/#woosmap.map.StoresService) class that unifies mapping and store search into a single library.

- **Use it for:** Interactive maps with store search, store locators built on Woosmap maps.
- **Key benefit:** A single library for all your location needs on the web.

**[See the Map JS StoresService Guide](/products/map-api/services/stores-search/)**

### 3. Store Locator Widget

A ready-made, customizable UI component that provides a complete store locator experience, including search, filtering, and map display.

- **Use it for:** Getting a full store locator running quickly with minimal code.
- **Key benefit:** Fast deployment with extensive configuration options.

**[Go to the Store Locator Widget Quickstart](/products/widgets/store-locator-widget/quick-start/)**

### 4. Mobile SDKs

Native SDKs for iOS and Android provide convenient tools for interacting with Stores API from mobile applications.

- **iOS SDK:** [Stores Service Reference](https://native-sdk.woosmap.com/ios/Woosmap/1.1.0/documentation/woosmap/wmstoresservice)
- **Android SDK:** [Displaying Stores Guide](/products/mobile/android/displaying-stores/) | [API Reference](https://native-sdk.woosmap.com/android/doc/latest/woosmap-sdk/com.woosmap.sdk.api.stores/index.html)
- **Flutter:** [Store Overlay Guide](/products/mobile/flutter/store-overlay/) | [Services Guide](/products/mobile/flutter/services/#stores-api)
- **React Native:** [Store Overlay Guide](/products/mobile/react-native/store-overlay/) | [Services Guide](/products/mobile/react-native/services/#stores-api)