Skip to content
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.
POSThttps://api.lobstr.io/v1/tasks

Add 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: 8dce74bb8c2330fdafee70baa22b4709

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY

Content-Typestringheaderrequired

Request 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"
    }
  ]
}