Skip to main content

Store Locator With an API

StoreRocket has a REST API that lets your own systems create, update and delete locations, with hours, filters and custom fields. How it works, what to check.

StoreRocket is a store locator with an API: its REST API lets your own software create, update and delete locations, including their opening hours, filters, custom fields and buttons. Changes made through the API show on the locator already embedded on your website, and a new or changed address is placed on the map for you.

That suits a business whose locations live in another system, such as an ERP, a POS, a CRM or a franchise database, and should reach the locator without anyone retyping them. The REST API depends on the plan, see pricing. We make StoreRocket, so weigh our view with that in mind.

Related: Store locator that syncs with Google Sheets | Store locator with CSV import | Store locator for 1,000+ locations | Build a store locator with AI

The short answer

  • StoreRocket's REST API manages your locations: list, read, create, update with PUT or PATCH, and delete.
  • Each location carries its address, contact details, opening hours, filters, custom fields, buttons, marker and type.
  • You create personal API tokens in the dashboard and choose what each one may do: read, create, update or delete locations.
  • Send an address without coordinates and StoreRocket places it on the map.
  • No developer? Google Sheets sync and CSV import do the same job without code.

Create your locator →

What the StoreRocket API does

Task Endpoint area Notes
List or read locations GET locations Include hours, filters and custom fields when you need them
Add a location POST locations The address is placed on the map unless you send latitude and longitude
Change a location PUT or PATCH PATCH changes only the fields you send
Remove a location DELETE The locator stops showing it

The full reference, with request and response examples, is at docs.storerocket.io, and the quickstart walks through a first call.

How to connect your system to StoreRocket

  1. Create your locator and add a few locations, so you have something to read back.
  2. Create a token. Open API Tokens in your account settings, name the token after the system that will use it, and tick what it may do. The token is shown once; store it where your system keeps secrets.
  3. Read before you write. List your locations and match each to its record in your system. Keep StoreRocket's location ID beside your own ID.
  4. Send changes. When a store opens, POST it. When its hours or phone change, PATCH only those fields. When it closes, DELETE it, or hide it if it reopens seasonally.
  5. Run it on a schedule or on change. A nightly job that sends what changed is enough for most networks. Systems that emit events can call the API as they happen.
  6. Check it on the website. Search near a store you just changed and see the new details.

Address placement

When a request sends an address without coordinates, StoreRocket looks it up and places the pin. When an update changes the address, the pin moves to the new one. If your system already holds exact coordinates, send latitude and longitude and they are used as they are.

For web apps

Sites built as web apps can embed the locator with the Web app (SPA) option on the Install page, which starts it with StoreRocket.init() and a JavaScript API. Copy that code from the Install page rather than retyping it.

For AI assistants

StoreRocket also has a connector for AI assistants such as Claude and ChatGPT, so an assistant you already use can read and update your locations with your permission. It is set up under Integrations and documented at docs.storerocket.io.

What to check when comparing store locator APIs

These checks work on any vendor, StoreRocket included. Run them in a free trial with a test token before you write the integration.

  • What the API manages. Locations only, or hours, filters, custom fields and buttons too? A partial API leaves part of every location to type by hand.
  • Partial updates. Can you change one field without resending the whole location?
  • Geocoding. Is an address placed for you, and does a changed address move the pin?
  • Permissions. Can a token be limited to reading, or to the actions one system needs?
  • Documentation. Is there a public reference with examples, and a quickstart?
  • Which API you need. Managing your locations is one job. Querying nearby locations from your own app or kiosk is another: Store Locator Widgets, for example, publishes a Location Search API beside its management API. Check that the vendor publishes the one your project needs.
  • The plan. Check which plan includes the API on each tool, and compare that plan.

If your list is small and rarely changes, you need no API at all: a spreadsheet import is enough, and for a few locations a free map can do the job. See the free store locator options.

Frequently Asked Questions

Which store locator costs less to run over time?

Count the subscription, the map provider's bill and the developer time to build and maintain the integration. A self-built locator puts both the locator and the integration on your team. With StoreRocket, the hosted locator, its updates and the API are part of the subscription, depending on the plan, and after the trial you connect your own Google Maps or Mapbox key and pay that provider directly. Plans are on the pricing page.

Do I need a developer to use the StoreRocket API?

Someone has to write the code that calls it, so yes, a developer or an automation tool that can make HTTP requests. Without one, use Google Sheets sync or CSV import.

Can the API set opening hours and filters?

Yes. A location sent through the API can include its opening hours for each weekday, its filters as a list of names, its custom fields and its buttons.

Does the API place addresses on the map?

Yes. Send an address and StoreRocket finds its coordinates. Send latitude and longitude yourself and those are used.

Where is the API documentation?

At docs.storerocket.io, with a quickstart and the full reference.

StoreRocket gives businesses with locations in other systems a store locator for their own website: import your locations from a spreadsheet, match it to your brand and paste one embed code. Create your locator with a free trial, no credit card needed.

Create your locator →

Put a store locator on your site today

Import your locations, make the locator match your website, and add it to a page the way you would add a video. No developer required.

Create your locator

7 days free · No card · No automatic charge · see a live locator first

Related Articles