Examples
Add Tasks
Add Reddit URLs to scrape posts, comments, user profiles, or subreddits
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/tasksAdd Reddit URLs to collect posts, comments, user profiles, or subreddit metadata. The scraper handles post threads (with nested comments), subreddit feeds, user profile pages, and global or subreddit-scoped search results.
Crawler ID:
6f99262f742b533d96936bf4088fba3eHeaders
AuthorizationstringheaderrequiredYour API authentication token. Value: Token YOUR_API_KEY
Content-TypestringheaderrequiredRequest body format. Value: application/json
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| squid | string | Yes | Hash of your squid configured with the Reddit Scraper crawler |
| tasks | array | Yes | Array of task objects, each containing a url field |
Task Object
| Field | Type | Required | Description |
|---|---|---|---|
| url | string | Yes | Reddit URL to scrape — see supported URL types below |
Supported URL Types
| Type | Example |
|---|---|
| Post thread | https://www.reddit.com/r/Bitcoin/comments/1rcbgsa/crypto_beginners/ |
| Subreddit | https://www.reddit.com/r/Bitcoin/ |
| User profile | https://www.reddit.com/user/thisisbillgates/ |
| Global search | https://www.reddit.com/search/?q=bitcoin |
| Subreddit search | https://www.reddit.com/r/Bitcoin/search/?q=lightning |
For post URLs, the scraper returns one row for the post itself and one row per comment. Use skip_comments or skip_posts in settings to limit output to just one type.
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.reddit.com/r/Bitcoin/" } ] }'
Response
200
{ "duplicated_count": 0, "tasks": [ { "id": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4", "created_at": "2026-05-20T10:00:00.000000", "is_active": true, "params": { "url": "https://www.reddit.com/r/Bitcoin/" }, "module": 118, "object": "task" } ] }