Get a scrape job
curl --request GET \
--url https://gmapscrawl.com/api/v1/scrapes/{job_id} \
--header 'API-KEY: <api-key>'import requests
url = "https://gmapscrawl.com/api/v1/scrapes/{job_id}"
headers = {"API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'API-KEY': '<api-key>'}};
fetch('https://gmapscrawl.com/api/v1/scrapes/{job_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"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"
}REST endpoints
Get a scrape job
Read durable scrape status and bounded progress without consuming a request unit.
GET
/
scrapes
/
{job_id}
Get a scrape job
curl --request GET \
--url https://gmapscrawl.com/api/v1/scrapes/{job_id} \
--header 'API-KEY: <api-key>'import requests
url = "https://gmapscrawl.com/api/v1/scrapes/{job_id}"
headers = {"API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'API-KEY': '<api-key>'}};
fetch('https://gmapscrawl.com/api/v1/scrapes/{job_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"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"
}⌘I