reddit

Subreddits › Search

Returns up to 25 communities matching a topic, each with the name at author.id, subscriber count, description and icon. include=details adds the creation date, weekly activity, rules and language.

Use it to find which communities discuss a subject.

Metered: 10–260 credits. We reserve the ceiling when the call starts and charge what it actually used when it finishes.

Paginates by cursor: see Pagination.

get/v1/reddit/subreddits/search

Request

  • Base URL: https://api.insightsocial.app
  • URL: https://api.insightsocial.app/v1/reddit/subreddits/search
  • Auth: API key in header x-api-key

Query parameters

querystring required
Example:machine learning

Topic or keyword to find communities for.

cursorstring

Cursor to get more results. Get 'cursor' from the previous response.

include'details'

Set to details (one token only) to fill author.joined_at, author.ext.weekly_active_users, author.ext.weekly_contributions, author.ext.rules_text and author.ext.language on every row in this one call (a row the details lookup cannot fully answer gets only the creation date and the language, and is still billed).

limitinteger

Take the top N communities of the page (1 to 25). It is not a page size: the cursor still advances past the whole page, so rows beyond N are not returned by the next page.

dry_run'1'

Set to 1 to get the price of this call without making it: data.dry_run carries credits_min and credits_max. Nothing is charged.

Response

Success.

successtrue required
platformstring required
endpointstring required
schema_version'2' required
unavailablestring[] required
credits_usedinteger required
credits_remaininginteger required
request_idstring required
cachedboolean required
idempotent_replayboolean required
charge_reasonstring required
free_callboolean required

Changes

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