REST API

Every metric and model, one API key away.

A predictable JSON API over HTTPS: places, visits, trade areas, market data and the full SDSS toolkit, with GeoJSON for anything that belongs on a map.

API calls / month on Pro
10k
API calls / month on Business
100k
EPSG:4326 FeatureCollections
GeoJSON
01

Keys you control

Create organization API keys in settings, name them per integration and revoke them instantly. Secrets are shown once and sent as a bearer token.

  • Up to 3 keys on Pro, 10 on Business
  • Last-used timestamps
  • Usage dashboard by month
02

Same models as the app

Suitability, Huff forecasts, catchments and site comparisons run on the same engine the app uses, so a notebook and a dashboard always agree.

  • POST /sdss/suitability
  • POST /sdss/huff
  • POST /sdss/catchment
03

Boring in the best way

Consistent error envelopes with stable codes, limit/offset pagination, ISO dates, and plan limits reported as 402 so you can handle them explicitly.

  • Stable error codes
  • Versioned under /api/v1
  • CORS for your own front ends

Forecast a candidate site

One request returns predicted visits, market share, cannibalization and the trade area.

Endpoint groups

Reference
cities · hexes · neighborhoods · categories · brands · segments
Places
places · visits · hourly · trade-area · cross-shopping · nearby · compare
Market
market overview · rankings · brand performance
SDSS
suitability · huff · catchment · compare-sites
Workspace
projects · favorites · alerts · keys · usage
Read the docs
curl https://api.mapdove.com/api/v1/sdss/huff \
  -H "Authorization: Bearer $MAPDOVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"austin","category":"coffee","lng":-97.705,"lat":30.298,"sqft":2200,"brand_strength":1.1}'

Frequently asked

Which plans include the API?

Pro (10,000 calls/month), Business (100,000) and Enterprise (unlimited). The Free plan has no API access.

Do SDSS calls count twice?

An SDSS call made with an API key counts as one API call and one analysis.

Is there a sandbox?

The demo cities are the sandbox: synthetic, deterministic and safe to experiment with.

See it on your own shortlist

Start free with the demo cities, or book a walkthrough with our team.