Add Tasks
Add Google Maps place URLs to scrape reviews from
https://api.lobstr.io/v1/tasksAdd Google Maps place URLs as tasks to your squid. The scraper will extract reviews from each place you provide.
You can use either the short CID format or the full Google Maps URL.
e625ce52e98a6d4d1b53ef36dff7dacbHeaders
AuthorizationstringheaderrequiredYour API authentication token. Value: Token YOUR_API_KEY
Content-TypestringheaderrequiredRequest body format. Value: application/json
Supported URL Formats
Short CID format:
https://maps.google.com/?cid=1357935577401699828
Full Google Maps URL:
https://www.google.com/maps/place/Restaurant+Name/@48.8499542,2.3524796,17z/...
Both formats work - use whichever is easier for your workflow.
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| squid | string | Yes | Hash of your squid configured with the google-maps-reviews-scraper crawler |
| tasks | array | Yes | Array of task objects, each containing a url field |
You can add up to 1000 tasks in a single request for bulk operations.
The CID (Customer ID) can be found in the Google Maps URL after cid= or extracted from the place's share link.
Duplicate URLs are automatically detected and won't be added twice.
Code Examples
curl -X POST "https://api.lobstr.io/v1/tasks" \ -H "Authorization: Token YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "squid": "b6ab0f03b02e472a8e2ab0b16b4fdd0f", "tasks": [ {"url": "https://maps.google.com/?cid=1357935577401699828"}, {"url": "https://www.google.com/maps/place/La+Tour+d'\''Argent/@48.8499542,2.3524796,17z"} ] }'
Response
{ "duplicated_count": 0, "tasks": [ { "id": "8c15009a391a79151873fe9451285e90", "created_at": "2025-03-17T11:56:51.691986", "is_active": true, "params": { "url": "https://maps.google.com/?cid=1357935577401699828" }, "object": "task" }, { "id": "a6ed45088d82beef3d254679457b5eb6", "created_at": "2025-03-17T11:56:51.692109", "is_active": true, "params": { "url": "https://www.google.com/maps/place/La+Tour+d'Argent/@48.8499542,2.3524796,17z" }, "object": "task" } ] }