← API Store
SocialReddit
A Reddit user's posts
GET /reddit/v1/user/postsEach post has score, upvote ratio, comment count, awards, flair, media (video, gallery, images) and flags. Pagination: pass the cursor from next_cursor on the previous response; next_cursor is null on the last page.
Every response includes credits_used: the credits this call cost.
Each call costs 1 credits; failed calls are free. Run it in the console playground to see a live result.
Parameters
| Name | Type | Description |
|---|---|---|
usernamerequired | string | Example: GallowBoob |
sort | new | hot | top | controversial | new (default), hot, top or controversial. Pass the same sort and time with the cursor. |
time | hour | day | week | month | year | all | With top/controversial: hour, day, week, month, year (default) or all. |
cursor | string | Cursor from `next_cursor` on the previous response; `next_cursor` is null on the last page. |
Every endpoint also takes: raw、fields、fresh、output、records
{
"cached": false,
"count": 25,
"credits_used": 1,
"feed": {
"category": "u_GallowBoob",
"category_label": "u/GallowBoob",
"icon": "https://www.redditstatic.com/icon.png/",
"logo": null,
"subtitle": "The internet was a mistake 🌍 Always remember the human.",
"title": "submitted by GallowBoob",
"updated": "2026-10-23T19:34:29+00:00",
"url": "https://www.reddit.com/user/GallowBoob/submitted/"
},
"next_cursor": "t3_zgkubx",
"posts": [
{
"author": "GallowBoob",
"author_url": "https://www.reddit.com/user/GallowBoob",
"category_label": "u/GallowBoob",
"content_html": "<table> <tr><td> <a href=\"https://www.reddit.com/r/u_GallowBoob/comments/fgghrs/everything_in_balance_except_karma/\"> <img src=\"https://prev…",
"external_url": "https://i.redd.it/41i4qishgvl41.jpg",
"id": "t3_fgghrs",
"images": [
"https://preview.redd.it/41i4qishgvl41.jpg?width=640&crop=smart&auto=webp&s=cffa3a800d9d0132e434f81e1b8ebd72fbeaa447",
"https://i.redd.it/41i4qishgvl41.jpg"
],
"links": [],
"permalink": "/r/u_GallowBoob/comments/fgghrs/everything_in_balance_except_karma/",
"published": "2020-03-10T16:27:45+00:00",
"subreddit": "u_GallowBoob",
"text": null,
"thumbnail": "https://preview.redd.it/41i4qishgvl41.jpg?width=640&crop=smart&auto=webp&s=cffa3a800d9d0132e434f81e1b8ebd72fbeaa447",
"title": "Everything in balance. Except karma ⬆️⬆️⬆️",
"updated": "2020-03-10T16:27:45+00:00",
"url": "https://www.reddit.com/r/u_GallowBoob/comments/fgghrs/everything_in_balance_except_karma/",
"videos": []
},
{
"author": "GallowBoob",
"author_url": "https://www.reddit.com/user/GallowBoob",
"category_label": "r/aww",
"content_html": "<table> <tr><td> <a href=\"https://www.reddit.com/r/aww/comments/1x1pjzw/shes_2_years_old/\"> <img src=\"https://preview.redd.it/tbq8zdb1vguh1.…",
"external_url": "https://i.redd.it/tbq8zdb1vguh1.jpeg",
"id": "t3_1x1pjzw",
"images": [
"https://preview.redd.it/tbq8zdb1vguh1.jpeg?width=640&crop=smart&auto=webp&s=9d10c0fea969e32b9a0968eb77a0fd2645f2a39c",
"https://i.redd.it/tbq8zdb1vguh1.jpeg"
],
"links": [],
"permalink": "/r/aww/comments/1x1pjzw/shes_2_years_old/",
"published": "2026-10-09T16:14:29+00:00",
"subreddit": "aww",
"text": null,
"thumbnail": "https://preview.redd.it/tbq8zdb1vguh1.jpeg?width=640&crop=smart&auto=webp&s=9d10c0fea969e32b9a0968eb77a0fd2645f2a39c",
"title": "She’s 2 years old! 🎉",
"updated": "2026-10-09T16:14:29+00:00",
"url": "https://www.reddit.com/r/aww/comments/1x1pjzw/shes_2_years_old/",
"videos": []
},
"… 23 more"
],
"username": "GallowBoob"
} Response fields (35)
Field paths and types observed in the sample response; the live response is authoritative.
$ | object |
$.cached | boolean |
$.count | integer |
$.credits_used | integer |
$.feed | object |
$.feed.category | string |
$.feed.category_label | string |
$.feed.icon | string |
$.feed.logo | null |
$.feed.subtitle | string |
$.feed.title | string |
$.feed.updated | string |
$.feed.url | string |
$.next_cursor | string |
$.posts | array |
$.posts[] | object | string |
$.posts[].author | string |
$.posts[].author_url | string |
$.posts[].category_label | string |
$.posts[].content_html | string |
$.posts[].external_url | string |
$.posts[].id | string |
$.posts[].images | array |
$.posts[].images[] | string |
$.posts[].links | array |
$.posts[].permalink | string |
$.posts[].published | string |
$.posts[].subreddit | string |
$.posts[].text | null |
$.posts[].thumbnail | string |
$.posts[].title | string |
$.posts[].updated | string |
$.posts[].url | string |
$.posts[].videos | array |
$.username | string |