tools

Search Reddit posts/comments or read a full comment thread — reads the Arctic Shift community archive (reddit.com blocks direct scraping). A scoped search (subreddit or author) queries the archive directly. A Reddit-wide keyword search finds posts with a site-restricted web search and then reads those posts from the archive — or, in comments mode, searches each of the first five posts' comments for the keywords — because Arctic Shift cannot keyword-search across all of Reddit. A scoped comment search Arctic Shift times out on is retried over the last 7d and 3d and reports window_applied. Arctic Shift is tried first and PullPush (api.pullpush.io) second: when Arctic Shift or the web-discovery path fails a posts or comments search, PullPush is queried and the response reports fallback_used. PullPush has refused automated clients since August 2026, so that fallback usually reports its refusal too.

post/tools/reddit_search

Request

  • Base URL: https://www.crawlforge.dev/api/v1
  • URL: https://www.crawlforge.dev/api/v1/tools/reddit_search
  • Auth: API key in header X-API-Key

Request body

querystring

Keyword search. Posts: matches title+selftext; comments: matches body. Supports "quoted phrases", OR, -exclusion

subredditstring

Limit to one subreddit (with or without the r/ prefix)

authorstring

Limit to one author (with or without the u/ prefix)

mode'posts' | 'comments' | 'thread'

What to search: posts (default), comments, or thread (full comment tree — requires link_id)

link_idstring

Post ID (e.g. '1twm1zh' or 't3_1twm1zh') — required for thread mode, optional filter for comments mode

afterstring

Only content posted after this date — ISO 8601, epoch seconds, or an offset like '7d'

beforestring

Only content posted before this date — same formats as after

limitinteger

Max results (1-100; thread mode: max comments returned)

sort'asc' | 'desc'

Sort by post date (desc = newest first)

source'auto' | 'arctic_shift' | 'pullpush' | 'web_discovery'

Force a specific backend: auto (Arctic Shift first, PullPush second), arctic_shift, web_discovery (unscoped keyword searches only — posts or comments), or pullpush (the automatic second source; has refused automated clients since August 2026)

Response

The tool's result; 5 credits charged (see x-credits-note and x-extra for add-ons).

successtrue required
dataobject required

The tool's result. Its shape is tool-specific and documented on the tool's docs page (x-docs-url on the operation).

credits_usedinteger required

Credits charged for this call: the operation's x-credits, plus any add-on x-credits-note or x-extra describes.

credits_remaininginteger required

The account's credit balance after this call.

processing_timeinteger required

Server-side processing time in milliseconds.

warningsstring[]

Non-fatal notes: a robots.txt override that was recorded, a format that could not be produced, a redaction that changed the payload.

Changes

No recorded changes to this operation across all 1 revision of this API.