InsightSocial APISubreddit › Details
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.
Authorization
apiKey Your key from the dashboard. It starts with isk_.
In: header
Query Parameters
Subreddit name without the r/ prefix. Case-sensitive: use the subreddit's canonical casing (e.g. AskReddit). Provide at least one of: subreddit, url.
Subreddit URL. Provide at least one of: subreddit, url.
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/details"{ "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}Search GET
Returns posts matching a keyword from across Reddit, each with title, score, comment count, subreddit, permalink, and the body at ext.selftext. Use it to search all of Reddit at once. Bodies arrive free here, so include_body=true is rarely needed and refunds what it does not spend. subreddit/search searches inside one community. **Metered: 20–680 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](/docs/pagination).
Subreddit › Search GET
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](/docs/pagination).