Media List

Retrieve a list of recent media (posts, reels, videos, pins, tweets, etc.) from a connected social media account. Supports all major platforms: Instagram, TikTok, YouTube, LinkedIn, Facebook, X (Twitter), Threads, Pinterest, Bluesky, and Reddit.

Useful for building post selectors, displaying recent content, or getting media IDs for other API calls.

---

Get User Media

Endpoint

GET /api/uploadposts/media

Headers

Name	Value	Description
Authorization	Apikey your-api-key-here	Your API key for authentication

Query Parameters

Name	Type	Required	Description
platform	String	Yes	The platform to retrieve media from. See Supported Platforms.
user	String	Yes	Profile username (as configured in Upload-Post).

Supported Platforms

Platform	Value	Description
Instagram	instagram	Posts, reels, and carousels
TikTok	tiktok	Videos
YouTube	youtube	Videos from the channel's uploads playlist
LinkedIn	linkedin	Posts (text, images, articles)
Facebook	facebook	Page/profile posts
X (Twitter)	x	Tweets with media information
Threads	threads	Thread posts
Pinterest	pinterest	Pins
Bluesky	bluesky	Posts (skeets)
Reddit	reddit	Submissions

Example Requests

Instagram:

curl 'https://api.upload-post.com/api/uploadposts/media?platform=instagram&user=my-profile' \
  -H 'Authorization: Apikey your-api-key-here'

TikTok:

curl 'https://api.upload-post.com/api/uploadposts/media?platform=tiktok&user=my-profile' \
  -H 'Authorization: Apikey your-api-key-here'

YouTube:

curl 'https://api.upload-post.com/api/uploadposts/media?platform=youtube&user=my-profile' \
  -H 'Authorization: Apikey your-api-key-here'

Responses

• 200 OK

{
  "success": true,
  "media": [
    {
      "id": "17890455123456789",
      "caption": "Check out our latest product launch!",
      "media_type": "IMAGE",
      "media_url": "https://scontent.xx.fbcdn.net/v/image123.jpg",
      "permalink": "https://www.instagram.com/p/ABC123/",
      "timestamp": "2025-06-15T10:30:00+0000",
      "thumbnail_url": null
    },
    {
      "id": "17890455987654321",
      "caption": "Behind the scenes",
      "media_type": "VIDEO",
      "media_url": "https://scontent.xx.fbcdn.net/v/video456.mp4",
      "permalink": "https://www.instagram.com/reel/DEF456/",
      "timestamp": "2025-06-14T15:00:00+0000",
      "thumbnail_url": "https://scontent.xx.fbcdn.net/..."
    },
    {
      "id": "17890455111222333",
      "caption": "Photo dump",
      "media_type": "CAROUSEL_ALBUM",
      "media_url": null,
      "permalink": "https://www.instagram.com/p/GHI789/",
      "timestamp": "2025-06-13T09:00:00+0000",
      "thumbnail_url": null
    }
  ]
}

• 400 Bad Request

{
  "success": false,
  "error": "Platform parameter is required"
}

• 500 Internal Server Error

{
  "success": false,
  "error": "An internal server error occurred."
}

Response Fields

All platforms return media items with a consistent structure:

Field	Type	Description
id	String	Platform-specific unique identifier for the media item
caption	String	Text content, caption, or title of the post
media_type	String	Type of media. See Media Types
media_url	String/null	Direct URL to the media file (image or video). See Media URL Availability
permalink	String/null	Direct URL to the post on the platform
timestamp	String/null	ISO 8601 timestamp of when the post was created
thumbnail_url	String/null	URL of the thumbnail/preview image (if available)

Media Types

Type	Description
IMAGE	Single photo post or image pin
VIDEO	Video post, reel, or video pin
CAROUSEL_ALBUM	Multi-image/video post (carousel)
TEXT	Text-only post (no media attached)

Media URL Availability

The media_url field returns a direct URL to the media file (image or video) when available. Support varies by platform:

Platform	media_url Support	Details
Instagram	Yes	Direct image/video URL. Not available for CAROUSEL_ALBUM parent (use children). May be omitted for copyrighted content. URLs are temporary.
Threads	Yes	Direct image/video URL, same behavior as Instagram.
Facebook	Yes	Image URL or playable video URL via attachments.
X (Twitter)	Yes	Direct photo URL. For videos, returns the preview image URL.
LinkedIn	Yes	Resolved via Images/Videos API. URLs are signed and temporary.
Reddit	Yes	Direct i.redd.it image URL, v.redd.it video URL (video-only, no audio), or first gallery image URL.
Bluesky	Yes	fullsize CDN image (up to 2000px) or HLS playlist URL (.m3u8) for videos.
Pinterest	Yes	Largest available image URL (up to 1200px or original). Video URLs are restricted by Pinterest.
TikTok	No	TikTok API does not expose direct video file URLs. Use permalink instead.
YouTube	No	YouTube API does not provide direct video URLs (prohibited by ToS). Use permalink instead.

warning

Media URLs from most platforms are temporary and will expire after some time (hours to days). Do not store them permanently — re-fetch from the API when needed, or download the media file to your own storage.

Common Use Cases

• Post selector UI: Display the user's recent posts so they can pick one for comment monitoring or AutoDMs.
• Get media IDs: Use the id field from the response as the post_id parameter in the Comments endpoint.
• Content overview: Show a dashboard of recent content across all platforms with permalinks and captions.
• Cross-platform analytics: Aggregate media from multiple platforms to display a unified content calendar.