InsightSocial API
Reddit

Subreddit › Search

GET
/v1/reddit/subreddit/search

Returns posts matching a query inside one subreddit, each with title, score, comment count, and permalink. This source sends no post body, so ext.selftext is null without include_body.

Use it to search one community. Bodies cost extra here, so prefer search with query=subreddit:name plus your terms: bodies for one credit, though it returns a different set of rows.

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

Re-running the exact same call within 1h is free.

Paginates by cursor — see Pagination.

Authorization

apiKey
x-api-key<token>

Your key from the dashboard. It starts with isk_.

In: header

Query Parameters

subreddit*string

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

query?string

Search query to find matching content

sort?string

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

Value in

  • "relevance"
  • "hot"
  • "top"
  • "new"
  • "comments"
timeframe?string

Only return posts from this window. Applied on sort=relevance, sort=top and sort=comments. It has no effect with sort=new, which is already ordered newest-first and returns recent posts regardless.

Value in

  • "all"
  • "year"
  • "month"
  • "week"
  • "day"
  • "hour"
cursor?string

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

include_body?boolean

Set to true to include each post's body (selftext) on the search page. Link posts have no body, so they are looked up and not charged for.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/reddit/subreddit/search?subreddit=string"
{  "success": true,  "platform": "instagram",  "endpoint": "/v1/instagram/profile/posts",  "data": {    "items": [      "…"    ],    "dropped": 0  },  "pagination": {    "next_cursor": "is2.eyJwIjoyfQ",    "has_more": true,    "page_size": 12  },  "credits_used": 20,  "credits_remaining": 9980,  "request_id": "req_1a2b3c4d5e6f",  "cached": false,  "idempotent_replay": false,  "charge_reason": "miss",  "free_call": false}

Subreddit › Details GET

Returns a subreddit's own details: subscriber count, active user count, description, creation date, rules, and icon URL. Use it to size up a community before pulling its posts; the name is case-sensitive here, so spell it exactly as Reddit does. **20 credits** per call. Re-running the exact same call within 6h is free.

Subreddit GET

Returns posts from a subreddit, each with title, body, score, comment count, author, permalink, and creation timestamp. Use it to read a community's feed, noting timeframe works only with sort=top, which is auto-selected when you omit sort; subreddit/search filters that same community by keyword. **Metered: 20–100 credits.** We reserve the ceiling when the call starts and charge what it actually used when it finishes. Re-running the exact same call within 6h is free. Paginates by `cursor` — see [Pagination](/docs/pagination).