API Documentation

Use the API to create map search jobs, monitor progress and export structured business data.

Authentication

All API requests require a bearer token.

Authorization: Bearer YOUR_API_KEY

Create search job

POST /v1/search

{
  "query": "restaurants in Madrid",
  "limit": 100,
  "language": "en",
  "region": "Spain"
}

Job status

GET /v1/jobs/{job_id}

{
  "job_id": "job_8fa21",
  "status": "completed",
  "progress": 100
}

Results

GET /v1/jobs/{job_id}/results

{
  "data": [
    {
      "name": "Example Business",
      "category": "Restaurant",
      "address": "Barcelona, Spain",
      "website": "https://example.com",
      "phone": "+34...",
      "rating": 4.7,
      "reviews": 128
    }
  ]
}