Skip to content
Examples

Update Settings

Configure the Instagram Reels Scraper settings including result limits

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/squids/{squid_hash}

Configure your Instagram Reels Scraper squid settings. Control the maximum number of reels collected per task and across the entire run.

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY

Content-Typestringheaderrequired

Request body format. Value: application/json

Scraper Parameters

Set these parameters in the params object:

Parameter Type Default Description
max_results integer unlimited Maximum number of reels to collect per task (profile)
max_unique_results_per_run integer unlimited Maximum number of unique results retrieved across all tasks in the entire run
fetch_since string null Stop scraping when items older than this threshold are reached (based on published_at). Use a relative duration (24h, 7d, 2w) or an absolute date (YYYY-MM-DD HH:MM:SS)
fetch_since_timezone string null Timezone for interpreting an absolute fetch_since date (e.g. Europe/Paris). Only applies when fetch_since is an absolute date — ignored for relative values like 24h or 7d. See supported timezones.
skip_pinned_reels boolean false If enabled, pinned reels will be excluded from the results

Squid Settings

Configure general squid settings:

Setting Type Description
name string Display name for your squid configuration
concurrency integer Number of parallel scraping threads (default: 1)
export_unique_results boolean Export only unique results (deduplicated)
to_complete boolean Run until all tasks complete
no_line_breaks boolean Remove line breaks from results

Understanding Limits

max_results: Limits reels collected from each profile URL. Useful when scraping multiple creator profiles.

max_unique_results_per_run: Global limit across all tasks. The scraper stops once this total is reached, regardless of individual task limits.

Set max_results to 50-100 when scraping multiple profiles to get a representative sample from each.

Leave limits empty or null for unlimited collection.

Large profiles can have thousands of reels. Set appropriate limits to control costs and processing time.

Code Examples

curl -X POST "https://api.lobstr.io/v1/squids/YOUR_SQUID_HASH" \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Instagram Reels Scraper (1)",
    "concurrency": 5,
    "export_unique_results": true,
    "to_complete": false,
    "no_line_breaks": true,
    "params": {
      "max_results": 50,
      "max_unique_results_per_run": 500,
      "fetch_since": "7d",
      "skip_pinned_reels": false
    }
  }'

Response

201
{
  "name": "Instagram Reels Scraper (1)",
  "concurrency": 5,
  "export_unique_results": true,
  "to_complete": false,
  "no_line_breaks": true,
  "params": {
    "max_results": 50,
    "max_unique_results_per_run": 500,
    "fetch_since": "7d",
    "skip_pinned_reels": false
  }
}