Accounts
List Creator Media
Lists the account's public media on platforms that support it, such as TikTok and Instagram. Results are paginated with a cursor.
GET
header
x-api-key<token>Workspace API key, sent in the x-api-key header. Keys start with op_ and are created in the dashboard.
id*stringLength
1 <= lengthlimit?integerItems per page. Defaults to 10. Maximum 20.
Range
1 <= value <= 20cursor?stringCursor from the previous response's nextCursor. Omit it for the first page.
kind?stringWhat to list. Defaults to media. Instagram also supports stories for active stories and audio to search the audio catalog. Audio search needs an Instagram account connected through Facebook Login.
Value in
"media""stories""audio"q?stringAudio search text, used with kind audio. When omitted, trending audio is returned.
Length
1 <= length <= 200audioType?stringType of audio to search, used with kind audio. Defaults to music.
Value in
"music""original_sound"Creator media page
application/json- response
accountId*stringplatform*stringitems*array<>nextCursor*string|nullExample Request
import { Configuration, ConnectionsApi } from "@onepostly/sdk";const connectionsApi = new ConnectionsApi( new Configuration({ apiKey: process.env.ONEPOSTLY_API_KEY }));const response = await connectionsApi.listConnectionMedia({ id: "a1b2c3d4-e5f6-4a7b-8c9d-e0f1a2b3c4d5", limit: 20, kind: "media", audioType: "music",});console.log(response);Example Response
{ "accountId": "a1b2c3d4-e5f6-4a7b-8c9d-e0f1a2b3c4d5", "platform": "tiktok", "items": [ { "id": "7412345678901234567", "title": "My trip", "description": "Weekend recap #travel", "coverUrl": "https://cdn.onepostly.com/media/cover.jpg", "shareUrl": "https://www.tiktok.com/@you/video/7412345678901234567", "createdAt": "2026-08-20T10:00:00.000Z", "durationSec": 42, "metrics": { "likes": 123, "comments": 12, "shares": 4, "views": 4567 } } ], "nextCursor": "20"}