GET/v1/reddit/subreddit/search

Subreddit Search

Subreddit Search Pagination billing: call the first page normally and save billing.requestId from the Orthogonal /v1/run response. For later page, offset, or cursor calls on the same logical search, pass parentRequestId with unchanged non-pagination parameters. Valid continuation calls still get their own request IDs and quoted price, but are charged 0. Changing filters starts a new billable request.

Scrape Creators·$0.02 per call

Example code

// Using @orth/sdk - The simplest way to call APIs
// Install: npm install @orth/sdk
import Orthogonal from "@orth/sdk";

const orthogonal = new Orthogonal({
  apiKey: process.env.ORTHOGONAL_API_KEY,
});

const output = await orthogonal.run({
  api: "scrapecreators",
  path: "/v1/reddit/subreddit/search",
  query: {
    "subreddit": "example"
  }
});

console.log(output);

Query parameters

subredditrequired

string

Subreddit name (e.g. 'Fitness', not 'r/Fitness' or a full URL)

query

string

Search query to find matching content

filter

select

Type of content to search for (default: posts). Response will only include the matching key (e.g. filter=posts returns only 'posts', not 'comments' or 'media')

sort

select

Sort order. For posts/media: relevance, hot, top, new, comments. For comments: relevance, top, new

timeframe

select

Timeframe to filter results

cursor

string

Cursor to get more results. Get 'cursor' from previous response. For later cursor pages of the same logical search, keep non-pagination parameters unchanged and pass top-level parentRequestId from the first Orthogonal /v1/run response.

Response

posts.0.id

string

posts.0.ups

number

posts.0.url

string

posts.0.name

string

posts.0.downs

number

posts.0.score

number

posts.0.title

string

posts.0.author

string

posts.0.created

number

posts.0.over_18

boolean

posts.0.spoiler

boolean

posts.0.is_video

boolean

posts.0.selftext

null

posts.0.permalink

string

posts.0.subreddit

string

posts.0.created_utc

number

posts.0.num_comments

number

posts.0.upvote_ratio

null

posts.0.selftext_html

null

posts.0.created_at_iso

string

posts.0.author_fullname

string

posts.0.relative_position

number

posts.0.subreddit_subscribers

null

posts.0.total_awards_received

null

cursor

string

success

boolean

credits_remaining

number

priceCents

number

Actual Orthogonal credits charged for this /v1/run call. Accepted continuation pages are charged 0.

quotedPriceCents

number

Price this call would normally cost before continuation billing is applied.

billing.requestId

string

Unique Orthogonal request ID for this page or poll call. Save the first call requestId and pass it as parentRequestId on later pages.

billing.parentRequestId

string|null

Parent Orthogonal request ID when this call is a continuation of an earlier search.

billing.rootRequestId

string

Root Orthogonal request ID for the full logical search.

billing.continuation

boolean

True when this call was accepted as a continuation page or poll.

billing.billable

boolean

False for accepted continuation pages because they are not charged again.

billing.quotedPriceCents

number

Quoted price for this page or poll before continuation billing.

billing.chargedPriceCents

number

Actual credits charged for this page or poll. Accepted continuations return 0.

billing.aggregateChargedPriceCents

number

Total charged so far for the full logical search, including the first page and accepted continuations.