Build with the Maptera REST API
When a no-code embed isn't enough, the REST API gives you full control. Query your locations as JSON, run nearest-store lookups, and power custom maps, apps, and kiosks— all with a single API key.
Core concepts
The API is small and predictable—a handful of JSON endpoints secured with a key. Here's what you need to know before your first request.
API keys
Generate a key in your dashboard after signup. Pass it as a Bearer token in the Authorization header on every request. Rotate or revoke keys anytime.
Resources
The API exposes your locations as JSON. List and filter stores, fetch a single location by ID, and run proximity searches—all over plain HTTPS.
Nearest-store search
Send a latitude/longitude (or let Maptera geocode an address) and get the closest locations back, sorted by distance, with the radius and result count you specify.
Stable & versioned
Endpoints live under /api/v1 so your integration keeps working as the platform evolves. Responses are predictable JSON with clear fields.
Find the nearest stores
Pass a point and a radius, get back the closest locations sorted by distance. Swap in your own key and coordinates.
Request
curl "https://maptera.switchlabs.dev/api/v1/stores/nearby?lat=40.7484&lng=-73.9857&radius=10&limit=5" \
-H "Authorization: Bearer YOUR_API_KEY"Response
{
"results": [
{
"id": "loc_8f2a",
"name": "Midtown Flagship",
"address": "350 5th Ave",
"city": "New York",
"state": "NY",
"zip": "10118",
"phone": "(212) 555-0142",
"latitude": 40.7484,
"longitude": -73.9857,
"distance_mi": 0.2,
"hours": "Mon-Sat: 9am-9pm"
}
],
"count": 1
}Getting started
From account to first response in four steps.
Create an account and choose a plan with API access
Sign up for free, then upgrade to a plan that includes REST API access (available on Enterprise). API access unlocks programmatic queries against your locations.
Generate an API key
In your dashboard, open the API section and create a key. Treat it like a password—keep it server-side and rotate it if it’s ever exposed.
Make your first request
Call the nearby endpoint with a latitude, longitude, radius, and limit, passing your key as a Bearer token. You’ll get back the closest locations sorted by distance.
Build your experience
Use the JSON responses to power custom maps, mobile apps, in-store kiosks, or “find a location near you” widgets—however you want to present your stores.
API access on Enterprise
Full REST API access is included on the Enterprise plan ($59/month), along with unlimited store locations and custom integrations. Start free to explore the dashboard, then upgrade when you're ready to build.
Ready to help customers find your stores?
Get started today with our 14-day free trial. No credit card required.