Skip to main content

Reddit Detailed Posts

GET /api/uploadposts/reddit/detailed-posts/

Retrieves detailed posts from a Reddit account connected to a profile, including complete media information (images, galleries, and videos).


Method: GET

Endpoint URL: https://api.upload-post.com/api/uploadposts/reddit/detailed-posts/

Authentication:

A valid JSON Web Token (JWT) is required for authentication. The token must be included in the Authorization header as a Bearer token.

Authorization: Bearer <YOUR_JWT_TOKEN>

Query Parameters:

ParameterTypeRequiredDescription
profile_usernamestringYesUsername of the profile that has the Reddit account connected.

Example Request:

curl 'https://api.upload-post.com/api/uploadposts/reddit/detailed-posts/?profile_username=mi_perfil' \
--header 'Authorization: Bearer <YOUR_JWT_TOKEN>'

Example Successful Response (200 OK):

{
"posts": [
{
"id": "1abc123",
"title": "Título del post",
"subreddit": "programming",
"body": "Contenido del post o URL si es un link post",
"likes": 150,
"comments": 42,
"impressions": 1500,
"has_image": true,
"has_video": false,
"media": [
{
"type": "image",
"url": "https://i.redd.it/example.jpg",
"width": 1920,
"height": 1080
}
],
"url": "https://www.reddit.com/r/programming/comments/1abc123/titulo_del_post/",
"created_at": "2026-01-15T10:30:00+00:00",
"thumbnail": "https://b.thumbs.redditmedia.com/example.jpg"
}
]
}

Response Fields:

FieldTypeDescription
idstringUnique identifier of the Reddit post.
titlestringTitle of the post.
subredditstringName of the subreddit where the post was published.
bodystringContent of the post or URL if it's a link post.
likesintegerNumber of upvotes on the post.
commentsintegerNumber of comments on the post.
impressionsintegerNumber of views (uses view_count if available, otherwise score).
has_imagebooleanIndicates if the post contains images.
has_videobooleanIndicates if the post contains video.
mediaarrayArray of media objects attached to the post.
urlstringDirect URL to the post on Reddit.
created_atstringISO 8601 timestamp of when the post was created.
thumbnailstringURL of the post's thumbnail image.

Media Types:

TypeDescriptionAdditional Fields
imageIndividual or gallery imagewidth, height
videoVideo hosted on Redditwidth, height, duration
external_videoExternal video (YouTube, etc.)thumbnail, provider

Error Responses:

CodeMessageDescription
400Query parameter "profile_username" is required.The required parameter is missing.
400Profile 'X' has no Reddit account connected.The profile does not have a linked Reddit account.
400Reddit account 'X' not found.The Reddit account does not exist for the user.
500An internal server error occurred.Internal server error.

Notes:

  • Supports automatic pagination, fetching up to 2000 posts (20 pages × 100 posts).
  • Gallery posts include all images in the media array.
  • Image URLs are already unescaped (no &amp;).
  • impressions uses view_count if available, otherwise uses score as a fallback.