Skip to content
Examples

Add Tasks

Add Instagram reel URLs or profile URLs to scrape reels using the lobstr.io API

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/v2/squid/{squid_id}/task

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.

Crawler ID: 4aad3ef0de6a5cea65b48dd575531a8c

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY

Content-Typestringheaderrequired

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

Field Type Required Description
url string Yes Instagram 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/"
}