Discover

Description

Discover Reddit posts by query with cursor-based pagination. Returns post title, engagement metrics, and author/subreddit summaries. Ideal for trend tracking, topic monitoring, and content discovery.

Endpoint

GET api/v1/realtime/social/reddit/v1/discover/posts?query={query}

Parameters

Param
Required
Param Type
Description

query

Yes

Query Param

String | The comment id

cursor

No

Query Param

String | The pagination cursor

sort

No Defaults: NEW

Query Param

String | The sort order. Available values: NEW, TOP, HOT, RELEVANCE, COMMENT_COUNT.

range

No Defaults: ALL_TIME

Query Param

String | The time range (required when sort is TOP, COMMENT_COUNT, or RELEVANCE). Available values: PAST_HOUR, TODAY, PAST_WEEK, PAST_MONTH, PAST_YEAR, ALL_TIME.

Pagination

  • results per page: 0-10

  • max results per query: ~250

  • cursor path in the response: pageInfo.cursor

  • If pageInfo.cursor is null and pageInfo.hasNextPage is false, there are no additional pages available

chevron-rightExample Requesthashtag
chevron-rightExample Responsehashtag

Discover Users

Description

Discover Reddit users matching a free-text query. Returns user metadata including id, name, karma, and icons. Supports discovery of niche or related users for analysis.

Endpoint

GET api/v1/realtime/social/reddit/v1/discover/users?query={query}

Parameters

Param
Required
Param Type
Description

query

Yes

Query Param

String | The comment id

cursor

No

Query Param

String | The pagination cursor

Pagination

  • results per page: 0-25

  • max results per query: ~25

  • cursor path in the response: pageInfo.cursor

  • If pageInfo.cursor is null and pageInfo.hasNextPage is false, there are no additional pages available

chevron-rightExample Requesthashtag
chevron-rightExample Responsehashtag

Discover Comments

Description

Discover Reddit comments matching a free-text query. Returns comment content, author details, and parent post snapshot for context. Useful for mining discussions or monitoring topics across communities.

Endpoint

GET api/v1/realtime/social/reddit/v1/discover/comments?query={query}

Parameters

Param
Required
Param Type
Description

query

Yes

Query Param

String | The comment id

cursor

No

Query Param

String | The pagination cursor

sort

No Defaults: RELEVANCE

Query Param

String | The sort order. Available values: NEW, TOP, RELEVANCE.

Pagination

  • results per page: 0-25

  • max results per query: ~250

  • cursor path in the response: pageInfo.cursor

  • If pageInfo.cursor is null and pageInfo.hasNextPage is false, there are no additional pages available

chevron-rightExample Requesthashtag
chevron-rightExample Responsehashtag

Discover Subreddits

Description

Discover Reddit communities by name or description. Returns subreddit metadata including subscribers, description, and icons. Supports discovery of niche or related subreddits for analysis.

Endpoint

GET api/v1/realtime/social/reddit/v1/discover/subreddits?query={query}

Parameters

Param
Required
Param Type
Description

query

Yes

Query Param

String | The comment id

cursor

No

Query Param

String | The pagination cursor

Pagination

  • results per page: 0-15

  • max results per query: ~250

  • cursor path in the response: pageInfo.cursor

  • If pageInfo.cursor is null and pageInfo.hasNextPage is false, there are no additional pages available

chevron-rightExample Requesthashtag
chevron-rightExample Responsehashtag

Last updated