Store Locator API
for Developers
An out-of-the-box store locator that opens all the way up. Use it as your location data backend, script the widget, or automate location updates from your systems.
7-day free trial Plans from $25/mo All APIs included
Just need a drop-in locator? See how Storepoint works
// Find locations within 25 miles
const response = await fetch(
'https://api.storepoint.co/public/v1/'
+ TOKEN + '/locations'
+ '?lat=40.7128&lng=-74.006&radius=25'
);
const { data } = await response.json();
// Sorted by distance. Address, hours, tags,
// and custom fields on every location.
data.locations.forEach((location) => {
console.log(location.name, location.distance.value);
});Marketing runs the locations. You run the code.
Storepoint started as the locator marketing teams love: import a spreadsheet, sync a Google Sheet, match the brand, done. The developer platform keeps that split. Locations live in one dashboard anyone can use. Everything else is yours to script, query, and sync.
- Your team adds and edits locations without you
- You never build a location admin UI
- One source of truth for web, mobile, and kiosk
- Nobody files a ticket to update an address
"The design is professional and clean and custom to our brand. It's affordable and their customer service is exceptional. Love the sync to Google Sheets too."
Katie W. · Web Designer
Three APIs. Use one, or combine all three.
The drop-in locator needs no code at all. When a project calls for more, these are your entry points.
Build a completely custom UI.
Use Storepoint as your location data backend. Fetch locations over REST and build any frontend: React, Vue, native mobile, kiosks. Your team keeps managing locations in the dashboard.
- Radius search, keyword search, and tag filters
- Clean JSON with coordinates, distances, and custom fields
- Call it straight from the browser
GET /public/v1/{token}/locations
?lat=40.71&lng=-74.00
&radius=25
&search=downtown
# Locations sorted by distance,
# with tags, hours, and custom fieldsAutomate your location updates.
Push locations from your CRM, ERP, POS, or any internal system. Send an address and Storepoint geocodes it automatically. Your locator stays current on its own.
- Create, update, and delete over REST
- Automatic geocoding from plain addresses
- Changes appear on your locator instantly
POST /admin/v1/locations
Authorization: Bearer sk_your_api_key
{
"name": "Downtown Store",
"address": "123 Main St, New York, NY",
"tags": ["flagship", "retail"]
}Script our embedded locator.
Keep the built-in locator and make it do more. Listen for searches and clicks, set filters from your page, add custom map layers and your own filter UIs.
- Events for searches, clicks, and map interactions
- Methods for filters, language, layers, and lifecycle
- Custom filters with your own UI and logic
// React to visitor interactions
Storepoint.on('location-result-item-click', (location) => {
showBookingPanel(location);
trackEvent('store_selected');
});
// Drive the locator from your page
Storepoint.setFilters(['premium']);What you can build
Custom store locator
A locator that matches your design system exactly. Query API for the data, your framework for the UI.
Dealer or distributor finder
Power a dealer locator for your sales network. Filter by certification, product line, or territory.
Mobile app integration
Call the REST API from iOS, Android, or React Native. Same data your team manages in the dashboard.
"Where to buy" pages
Show customers where to find your product. Filter by retailer, product, or region. Embed on product pages.
Data pipeline sync
Push location updates from your CRM, ERP, or POS. The Management API keeps Storepoint current on its own.
Kiosk or in-store display
Location finders for kiosks and digital signage. The Query API returns clean JSON for any frontend.
Skip the infrastructure. Ship the feature.
Building a store locator from scratch means geocoding APIs, database schemas, radius calculations, a management UI, and ongoing maintenance. Storepoint handles all of that.
No geo infrastructure to manage
Geocoding, radius search, and distance sorting are handled for you. Maps work with Google Maps and Mapbox out of the box. Send coordinates and a radius, get sorted results.
A dashboard your team already gets
Marketing adds locations with spreadsheet import, Google Sheets sync, or one by one. Updates go live without a deploy, and without you.
Transparent, predictable pricing
Plans from $25/month. All APIs included. Zero per-request charges, so you know the cost before you build.
Clear docs. Fast support.
Complete API reference with code examples. Responses documented in full. Questions answered by the people who built it.
First API call in under 5 minutes
Sign up for a free trial and add a few test locations. Takes two minutes.
Open the Developer Portal in your dashboard. Enable the Query API and grab your public token. Generate a private key for the Management API.
Hit the endpoint from curl, Postman, or your code. Your locations come back as JSON.
$ curl "https://api.storepoint.co/public/v1/YOUR_TOKEN/locations?lat=40.7128&lng=-74.006&radius=25"
{
"success": true,
"data": {
"locations": [
{
"id": "loc_a1b2c3d4",
"name": "Downtown Store",
"coordinates": { "lat": 40.7128, "lng": -74.006 },
"address": { "formatted": "123 Main St, New York, NY 10001" },
"distance": { "value": 0.3, "unit": "miles" }
}
],
"pagination": { "total": 42, "hasMore": true }
}
}Explore the docs
Location Query API
Query locations by radius, keyword, or tag. Build custom store locators and location-based apps.
Location Management API
Create, update, and delete locations programmatically. Sync data from your existing systems.
Widget JavaScript API
Script the embedded locator. Events, methods, configuration, and custom filters.
All APIs included on every plan
Plans start at $25/month with zero per-request charges.
Common questions
Do I need an account to use the API?
Yes. Sign up for a free 7-day trial to get your API token. All plans include full API access with no per-request charges. Your token is available in the dashboard immediately after signup.
How do I enable the Location Query API?
Open the Developer Portal in your Storepoint dashboard and switch the Query API on. Your public token is on the same page, and you can restrict access to your own domains. The Management API works as soon as you generate a private API key there.
Can I use the API without the embed widget?
Yes. The Location Query API and Location Management API are completely independent from the widget. Build a fully custom frontend using your own tech stack while managing location data in the Storepoint dashboard. The widget is optional.
What authentication does the API use?
The Location Query API uses the public token from your dashboard, so you can call it straight from the browser. The Location Management API uses a private API key that stays on your server, for creating and updating locations. Full details in the API reference.
Is the API available on all plans?
Yes. Every plan includes full access to all three APIs: Location Query, Location Management, and Widget JavaScript. Zero API tier upsells. Plans start at $25/month.
Do I need to set up geocoding or map infrastructure?
No. Storepoint handles all geocoding, geolocation, and geographic search infrastructure. Add a location with an address and we geocode it automatically. The Query API handles radius-based search, distance calculations, and sorting by proximity. You just send coordinates and a radius.
Can I sync location data from my existing systems?
Yes. The Location Management API lets you programmatically create, update, and delete locations. Build a sync pipeline from your CRM, ERP, POS, or any internal system. Of course, you can also use Google Sheets sync or spreadsheet import via the dashboard for non-automated workflows.
What does the API response look like?
JSON. The Query API returns an array of locations with pagination. Each location includes name, address, coordinates, distance, phone, website, hours, tags, and any custom fields you've added in the dashboard. See the full API reference for the complete response schema.
Start building with Storepoint
Free 7-day trial. Every API included. First call in minutes.
Plans from $25/mo All APIs included Zero per-request charges