Skip to main content
POST
/
v2
/
squid
/
{squid_id}
/
task
Add Tasks
curl --request POST \
  --url https://api.lobstr.io/v2/squid/{squid_id}/task \
  --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 Instagram URLs as tasks to your squid. You can provide either a direct reel URL to scrape a specific reel, or a profile URL to collect all reels from that profile.

​
Headers

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

​
Supported URL Formats

Direct Reel URL: https://www.instagram.com/reel/ABC123xyz/ Profile URL (collects all reels from profile): https://www.instagram.com/username/ Post URL: https://www.instagram.com/p/ABC123xyz/

​
Request Body

FieldTypeRequiredDescription
urlstringYesInstagram Reel URL or Profile URL. If a profile URL is given, the scraper will collect reels from that profile.
Use profile URLs to bulk collect all reels from a creator’s account in one task.
When scraping a profile, use max_results setting to limit how many reels are collected per profile.
Both instagram.com and www.instagram.com URL formats are supported.

​
Code Examples

curl -X POST "https://api.lobstr.io/api/v2/squid/YOUR_SQUID_ID/task" \
  -H "Authorization: Token YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.instagram.com/leomessi/"
  }'

​
Response

200
{
  "id": "task_abc123def456",
  "status": "pending",
  "created_at": "2025-01-15T10:30:00Z",
  "url": "https://www.instagram.com/leomessi/"
}