InsightSocial API
Reddit

Profile › Posts

GET
/v1/reddit/profile/posts

Returns the posts one account has submitted, newest first, with the body at ext.selftext, score, comment count, upvote ratio, flair, media and ext.subreddit.

Use it to read one person's submissions across communities. An account with no posts and one that does not exist both return an empty list, so call profile to tell them apart.

20 credits per call.

Re-running the exact same call within 6h 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

handle*string

Reddit username without the u/ prefix. Case-insensitive.

sort?string

Sort order for the account's submissions. top defaults to the all-time window; pass timeframe to narrow it.

Value in

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

Only return posts from this window. Applied on sort=top. Omitted sort=top is treated as timeframe=all so the documented call is not an empty page.

Value in

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

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

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/profile/posts?handle=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}

Profile › Comments GET

Returns an account's own comment history, newest first, each with the text, score, permalink, parent_id, the post it sits under and ext.subreddit. Use it when you need a real comment history rather than a sample. **Metered: 40–4000 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 24h is free.

Profile GET

Returns one Reddit account: total karma, the post/comment/award karma split, cake day, bio, avatar, banner, trophy count and profile title. Use it to size or vet an account before reading its posts. author.followers is null on purpose: Reddit publishes no public follower count, so karma is the reach signal. **20 credits** per call. Re-running the exact same call within 24h is free.