API REST

Cada métrica e modelo, a uma chave de API de distância.

Uma API JSON previsível sobre HTTPS: locais, visitas, áreas de influência, dados de mercado e todo o kit SDSS, com GeoJSON para tudo o que pertence a um mapa.

chamadas de API / mês no Pro
10k
chamadas de API / mês no Business
100k
FeatureCollections em EPSG:4326
GeoJSON
01

Chaves sob o seu controle

Crie chaves de API da organização nas configurações, dê um nome para cada integração e revogue-as na hora. Os segredos são exibidos uma única vez e enviados como token Bearer.

  • Até 3 chaves no Pro e 10 no Business
  • Data e hora do último uso
  • Painel de uso por mês
02

Os mesmos modelos do app

Aptidão, previsões Huff, áreas de captação e comparações de pontos rodam no mesmo motor usado pelo app, então um notebook e um painel sempre concordam.

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

Previsível, no melhor sentido

Envelopes de erro consistentes com códigos estáveis, paginação limit/offset, datas ISO e limites do plano retornados como 402 para você tratá-los explicitamente.

  • Códigos de erro estáveis
  • Versionada em /api/v1
  • CORS para os seus próprios front-ends

Preveja um ponto candidato

Uma única solicitação retorna visitas previstas, participação de mercado, canibalização e a área de influência.

Grupos de endpoints

Referência
cities · hexes · neighborhoods · categories · brands · segments
Locais
places · visits · hourly · trade-area · cross-shopping · nearby · compare
Mercado
market overview · rankings · brand performance
SDSS
suitability · huff · catchment · compare-sites
Espaço de trabalho
projects · favorites · alerts · keys · usage
Ler a documentação
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}'

Perguntas frequentes

Quais planos incluem a API?

Pro (10.000 chamadas/mês), Business (100.000) e Enterprise (ilimitado). O plano Gratuito não tem acesso à API.

Chamadas SDSS contam em dobro?

Uma chamada SDSS feita com chave de API conta como uma chamada de API e uma análise.

Existe um sandbox?

Os dados hospedados servem também de sandbox: só mudam quando o conjunto de dados é atualizado, então os resultados são reproduzíveis e seguros para experimentar.

Veja na sua própria lista de pontos

Comece grátis com qualquer mercado dos EUA ou Dubai, ou agende uma apresentação com a nossa equipe.