Examples
Update Settings
Configure the Instagram Posts Scraper settings
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.
POST
https://api.lobstr.io/v1/squids/{squid_hash}Configure your Instagram Posts Scraper squid settings. Control the maximum number of posts collected, filter by time range, and exclude pinned posts.
Headers
AuthorizationstringheaderrequiredYour API authentication token. Value: Token YOUR_API_KEY
Content-TypestringheaderrequiredRequest body format. Value: application/json
Scraper Parameters
Set these parameters in the params object:
| Parameter | Type | Default | Description |
|---|---|---|---|
| max_results | integer | unlimited | Total posts the crawler will collect per profile |
| max_unique_results_per_run | integer | unlimited | Maximum number of unique posts retrieved across all tasks in the entire run |
| fetch_since | string | unlimited | 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) |
| 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_posts | boolean | false | If enabled, pinned posts will be excluded from the results |
| enrich_comments | boolean | true | Collect up to 15 latest comments per post (1 extra request per post). Disable for much faster scraping |
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 |
Use fetch_since to only collect recent posts - great for monitoring accounts for new content.
Leave limits empty or null for unlimited collection.
Enable skip_pinned_posts when you only want organic timeline posts without promotional pinned content.
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 '{ "export_unique_results": true, "params": { "max_results": 50, "max_unique_results_per_run": 1000, "fetch_since": "7d", "skip_pinned_posts": false } }'
Response
201
{ "export_unique_results": true, "params": { "max_results": 50, "max_unique_results_per_run": 1000, "fetch_since": "7d", "skip_pinned_posts": false } }