---
title: "Get media list"
method: GET
path: "/uploadposts/media"
tags: ["Platform Integration"]
---

# Get media list

`GET /uploadposts/media`

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

## Query parameters

- `platform` 'instagram' | 'tiktok' | 'youtube' | 'linkedin' | 'facebook' | 'x' | 'threads' | 'pinterest' | 'bluesky' | 'reddit', required
- `user` string, required
- `page_urn` string
- `limit` integer
- `cursor` string

## Response `200`

Media list retrieved successfully.

- object
  - `success` boolean
  - `media` object[]
    - `id` string — Platform-specific unique identifier for the media item.
    - `caption` string, nullable — Text content, caption, or title of the post.
    - `media_type` 'IMAGE' | 'VIDEO' | 'CAROUSEL_ALBUM' | 'TEXT' — Type of media content.
    - `media_url` string, nullable — Direct URL to the media file (image or video). Available on most platforms. Returns null for TikTok, YouTube, and when the platform does not provide a direct media URL. URLs are temporary and may expire.
    - `permalink` string, nullable — Direct URL to the post on the platform.
    - `timestamp` string, date-time, nullable — ISO 8601 timestamp of when the post was created.
    - `thumbnail_url` string, nullable — URL of the thumbnail or preview image.
  - `pagination` object — Page metadata. Additive: every pre-existing response key is unchanged.
    - `limit` integer — The effective limit applied after clamping and per-platform capping.
    - `next_cursor` string, nullable — Token to pass as 'cursor' on the next request. Null on the last page.
    - `has_more` boolean — True when another page is available.

## Other responses

- `400` — Missing or invalid parameters, platform account not linked, or a cursor was supplied for LinkedIn, Discord or Telegram (which do not support cursors).
- `500` — Internal server error.

## Changes

- **2026-07-31** `10bd964e4415` — 3 info
  - added the new optional `query` request parameter `cursor`
  - added the new optional `query` request parameter `limit`
  - added the optional property `pagination` to the response with the `200` status

[Change history](https://skmtc.dev/upload-post/apis/upload-post-api/changes/uploadposts/media/get.md)

---

[API](https://skmtc.dev/upload-post/apis/upload-post-api.md) · [All operations](https://skmtc.dev/upload-post/apis/upload-post-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/upload-post/upload-post-api/revisions/10bd964e4415/schema)