Examples
Add Tasks
Add YouTube channel URLs to scrape contact emails
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 YouTube channel URLs to scrape contact information including email addresses, social media links, and channel statistics. The scraper extracts data from the channel's About page.
Crawler ID:
8dce74bb8c2330fdafee70baa22b4709Headers
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 YouTube Channel Email Scraper |
| tasks | array | Yes | Array of task objects, each containing a url field |
Task Object
| Field | Type | Required | Description |
|---|---|---|---|
| url | string | Yes | YouTube channel URL (e.g., https://www.youtube.com/c/ChannelName or https://www.youtube.com/@handle) |
Supported URL Formats
The scraper accepts various YouTube channel URL formats:
| Format | Example |
|---|---|
| Custom URL | https://www.youtube.com/c/ChannelName |
| Handle URL | https://www.youtube.com/@channelhandle |
| Channel ID | https://www.youtube.com/channel/UCxxxxxxxxxxxxxxxx |
| User URL | https://www.youtube.com/user/username |
You can use any YouTube channel URL format - the scraper will resolve it to the correct channel.
Email addresses are only available if the channel owner has made them public in the About section.
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.youtube.com/c/TechLegend" } ] }'
Response
200
{ "duplicated_count": 0, "tasks": [ { "id": "82367f24d9450b2222080eed91662968", "created_at": "2025-07-17T09:06:47.287893", "is_active": true, "params": { "url": "https://www.youtube.com/c/TechLegend" }, "module": 115, "object": "task" } ] }