Skip to main content
POST
/
v1
/
tasks
Add Tasks
curl --request POST \
  --url https://api.lobstr.io/v1/tasks \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>'

Documentation Index

Fetch the complete documentation index at: https://docs.lobstr.io/llms.txt

Use this file to discover all available pages before exploring further.

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.

​
Headers

​
Authorization
string
required
Your API authentication token. Value: Token YOUR_API_KEY
​
Content-Type
string
required
Request body format. Value: application/json

​
Request Body

FieldTypeRequiredDescription
squidstringYesHash of your squid configured with the YouTube Channel Email Scraper
tasksarrayYesArray of task objects, each containing a url field

​
Task Object

FieldTypeRequiredDescription
urlstringYesYouTube 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:
FormatExample
Custom URLhttps://www.youtube.com/c/ChannelName
Handle URLhttps://www.youtube.com/@channelhandle
Channel IDhttps://www.youtube.com/channel/UCxxxxxxxxxxxxxxxx
User URLhttps://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"
    }
  ]
}