Examples
Add Tasks
Add Yelp business URLs to scrape reviews
The v1 API, for batchesSquids, tasks and runs: many calls on a schedule, delivered where you work. For one call that answers in seconds, use the API v2.
POST
https://api.lobstr.io/v1/tasksAdd Yelp business page URLs to collect all reviews for each business. The scraper extracts the full review text, star rating, reviewer profile, photos, and community votes.
Crawler ID:
ea1c83f60e32a4e1de91a1ed1e41b268Headers
AuthorizationstringheaderrequiredYour API authentication token. Value: Token YOUR_API_KEY
Content-TypestringheaderrequiredRequest body format. Value: application/json
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| squid | string | Yes | Hash of your squid configured with the Yelp Reviews Export crawler |
| tasks | array | Yes | Array of task objects, each containing a url field |
Task Object
| Field | Type | Required | Description |
|---|---|---|---|
| url | string | Yes | Full Yelp business URL — must contain /biz/<alias> (e.g., https://www.yelp.com/biz/olio-e-piu-new-york-7). Also accepts country variants (yelp.fr, yelp.co.uk, etc.) |
Find the business on Yelp, then copy the URL from the address bar. Make sure it contains /biz/ — not a search URL.
Code Examples
curl -X POST "https://api.lobstr.io/v1/tasks" \ -H "Authorization: Token YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "squid": "YOUR_SQUID_HASH", "tasks": [ { "url": "https://www.yelp.com/biz/olio-e-piu-new-york-7" } ] }'
Response
200
{ "duplicated_count": 0, "tasks": [ { "id": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4", "created_at": "2026-05-12T10:00:00.000000", "is_active": true, "params": { "url": "https://www.yelp.com/biz/olio-e-piu-new-york-7" }, "module": 116, "object": "task" } ] }