Start an async job to scrape Reddit posts, comments, communities, or users by subreddit URL, post URL, user URL, or sear…
Authentication
No API key — create one in the dashboard
Body
Reddit URLs to scrape — subreddit, post, user, or search URLs. Maximum 25.
Search queries to run on Reddit. One scrape run is performed per query. Maximum 25.
What the search queries return: posts, comments, communities, or users. Defaults to "posts".
Restrict search queries to a single community (e.g. "sales"). Applies to searchQueries only.
Sort order applied to results.
Time filter for results. Only applies when sort is "top" or "relevance".
Maximum number of items (posts, comments, communities, or users) to return (1–200). Defaults to 10. Credits are reserved upfront based on this value and settled to the actual count returned.
Maximum number of comments to fetch per post (only when comments are included). Set 0 to skip comment scraping entirely. Maximum 1000.
When true, includes top-level comments alongside each post.
Only return posts published on or after this date (ISO 8601, e.g. "2025-01-01").
Only return comments published on or after this date (ISO 8601, e.g. "2025-01-01").
import requests url = "https://api.coldiq.com/v1/reddit/scrape" headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, headers=headers) print(response.json())