AI SERP API
Map Data API
Synchronous single-task API for Google Maps. Extract business names, ratings, and addresses for a single URL or keyword per request with immediate data return.
API Description
Map Data API – Single task query (supports querying one URL or keyword per request).
The Map Data API extracts structured information from Maps search result pages and business listing pages, including business names, ratings, hours, addresses, and external links.
It enables sellers to perform offline competitor research, regional market analysis, and brand distribution mapping, providing a broader market perspective for product selection, channel expansion, and local marketing decisions.
Request URL
Request Headers
| Parameters | Parameter value | Type | Description |
|---|---|---|---|
| Content-Type | application/json | string | Data format |
| Authorization | Bearer xxx | string | Authorization Token |
Request Parameters
| Parameters | Required | Type | Description |
|---|---|---|---|
| query | Yes | string | Search keyword |
| ll | Yes | string | Location parameters: latitude, longitude, zoom |
| hl | No | string | Interface language |
| num | No | int | Items per page |
| from | No | int | Page start |
| timeout | No | int | Task timeout |
| url | No | string | Collect data from a specified address. If this parameter is provided, all other parameters will be ignored. |
Response value
| Return value | Type | Description |
|---|---|---|
| status | int | Task status: -1 = Failed, 1 = In Progress, 2 = Successful |
| taskId | string | Task ID |
| url | string | Task source URL |
| data | object | Parsed or collected results |
| errorMessage | string | Error message |
| html | string | Original HTML content encoded in Base64 |
Request example
Return example
Credit Consumption
- Average response time:
5s - Credit Consumption:
1.5 Credits/Per Request

