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
| 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 |
| hl | No | string | Interface language |
| ll | No | string | Location parameters: latitude, longitude, zoom |
| 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