InsightSocial APIReddit Subreddits Search API reference
Your first 10 calls are free, no card needed. Pricing and FAQ
Get a free API keycurl "https://api.insightsocial.app/v1/reddit/subreddits/search?query=machine%20learning" \ -H "x-api-key: $INSIGHTSOCIAL_API_KEY"
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. Send include=details instead of one subreddit/details call per community, plus 1 per row filled, 26 at most.
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.
Authorization
apiKey Your key from the dashboard. It starts with isk_.
In: header
Query Parameters
Topic or keyword to find communities for.
Cursor to get more results. Get 'cursor' from the previous response.
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's main source cannot answer gets only the creation date and the language, and is still billed).
Value in
- "details"
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.
1 <= value <= 25Set to 1 to get the price of this call without making it: data.dry_run carries credits_min and credits_max. Nothing is charged.
Value in
- "1"
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.insightsocial.app/v1/reddit/subreddits/search?query=string"{ "success": true, "platform": "string", "endpoint": "string", "schema_version": "2", "pagination": { "next_cursor": "string", "has_more": true, "page_size": 0, "stopped_at": "since" }, "unavailable": [ "string" ], "credits_used": 0, "credits_remaining": 0, "request_id": "string", "cached": true, "idempotent_replay": true, "charge_reason": "string", "free_call": true, "data": { "items": [ { "author": { "id": "string", "username": "string", "display_name": "string", "avatar_url": "http://example.com", "bio": "string", "verified": true, "followers": 0, "followers_approximate": true, "following": 0, "posts_count": 0, "likes_count": 0, "url": "http://example.com", "location": "string", "external_url": "http://example.com", "private": true, "joined_at": "2019-08-24T14:15:22Z", "last_post_at": "2019-08-24T14:15:22Z", "ext": { "property1": null, "property2": null } } } ], "total": 0, "truncated": true, "ext": { "property1": null, "property2": null } }}