Create a durable Google Maps scrape

curl --request POST \
  --url https://gmapscrawl.com/api/v1/scrapes \
  --header 'API-KEY: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "operation": "places.search",
  "input": {
    "q": "coffee shops in Seattle",
    "page": 1,
    "hl": "en",
    "gl": "us",
    "extra": false
  }
}
'

{
  "data": {
    "id": "job_01K4GMAPSEXAMPLE0000000000",
    "operation": "places.search",
    "status": "queued",
    "created_at": "2026-09-01T10:00:00.000Z",
    "progress": {
      "completed_queries": 0,
      "total_queries": 1
    },
    "links": {
      "self": "/api/v1/scrapes/job_01K4GMAPSEXAMPLE0000000000",
      "results": "/api/v1/scrapes/job_01K4GMAPSEXAMPLE0000000000/results"
    }
  },
  "request_id": "req_01K4GMAPSEXAMPLE0000000000",
  "schema_version": "2026-09-22"
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "details": [
      "<string>"
    ],
    "retryable": true
  },
  "request_id": "<string>",
  "schema_version": "2026-09-22"
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "details": [
      "<string>"
    ],
    "retryable": true
  },
  "request_id": "<string>",
  "schema_version": "2026-09-22"
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "details": [
      "<string>"
    ],
    "retryable": true
  },
  "request_id": "<string>",
  "schema_version": "2026-09-22"
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "details": [
      "<string>"
    ],
    "retryable": true
  },
  "request_id": "<string>",
  "schema_version": "2026-09-22"
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "details": [
      "<string>"
    ],
    "retryable": true
  },
  "request_id": "<string>",
  "schema_version": "2026-09-22"
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "details": [
      "<string>"
    ],
    "retryable": true
  },
  "request_id": "<string>",
  "schema_version": "2026-09-22"
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "details": [
      "<string>"
    ],
    "retryable": true
  },
  "request_id": "<string>",
  "schema_version": "2026-09-22"
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "details": [
      "<string>"
    ],
    "retryable": true
  },
  "request_id": "<string>",
  "schema_version": "2026-09-22"
}

POST

scrapes

curl --request POST \
  --url https://gmapscrawl.com/api/v1/scrapes \
  --header 'API-KEY: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "operation": "places.search",
  "input": {
    "q": "coffee shops in Seattle",
    "page": 1,
    "hl": "en",
    "gl": "us",
    "extra": false
  }
}
'

{
  "data": {
    "id": "job_01K4GMAPSEXAMPLE0000000000",
    "operation": "places.search",
    "status": "queued",
    "created_at": "2026-09-01T10:00:00.000Z",
    "progress": {
      "completed_queries": 0,
      "total_queries": 1
    },
    "links": {
      "self": "/api/v1/scrapes/job_01K4GMAPSEXAMPLE0000000000",
      "results": "/api/v1/scrapes/job_01K4GMAPSEXAMPLE0000000000/results"
    }
  },
  "request_id": "req_01K4GMAPSEXAMPLE0000000000",
  "schema_version": "2026-09-22"
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "details": [
      "<string>"
    ],
    "retryable": true
  },
  "request_id": "<string>",
  "schema_version": "2026-09-22"
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "details": [
      "<string>"
    ],
    "retryable": true
  },
  "request_id": "<string>",
  "schema_version": "2026-09-22"
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "details": [
      "<string>"
    ],
    "retryable": true
  },
  "request_id": "<string>",
  "schema_version": "2026-09-22"
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "details": [
      "<string>"
    ],
    "retryable": true
  },
  "request_id": "<string>",
  "schema_version": "2026-09-22"
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "details": [
      "<string>"
    ],
    "retryable": true
  },
  "request_id": "<string>",
  "schema_version": "2026-09-22"
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "details": [
      "<string>"
    ],
    "retryable": true
  },
  "request_id": "<string>",
  "schema_version": "2026-09-22"
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "details": [
      "<string>"
    ],
    "retryable": true
  },
  "request_id": "<string>",
  "schema_version": "2026-09-22"
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "details": [
      "<string>"
    ],
    "retryable": true
  },
  "request_id": "<string>",
  "schema_version": "2026-09-22"
}

Live access is capability-gated. Test keys return simulated fixtures. Standalone live Reviews and Photos are unavailable. See availability.

Authorizations

API-KEY

string

header

required

Headers

Idempotency-Key

string

required

Required string length: 16 - 128

Pattern: ^[\x21-\x7e]+$

Prefer

string

Pattern: ^wait=(?:[1-9]|1\d|2[0-5])$

Body

application/json

Option 1
Option 2
Option 3

operation

string

required

Allowed value: "places.search"

input

object

required

Show child attributes

Response

Successful response

data

object

required

Show child attributes

request_id

string

required

Pattern: ^req_[A-Za-z0-9_-]+$

schema_version

string

required

Allowed value: "2026-09-22"