Skip to main content
GET

List Published Projects

Retrieve a paginated list of your published posts across YouTube, TikTok, Instagram, X (Twitter), Facebook, and LinkedIn. Each entry includes per-platform delivery status, post URLs, and analytics where available, plus a totals rollup aggregated across the post’s platforms.
This endpoint requires authentication.

Authentication

string
required
Your Submagic API key starting with sk-

Query Parameters

string
Filter by platform. Allowed values: youtube, tiktok, instagram, twitter, facebook, linkedin.
string
Filter to a single profile (UUID). Copy the id from the Copy profile ID action in the publishing dashboard’s profile selector.
string
Start of the date range (ISO 8601). Filters by publishedAt. When omitted, results include everything published up to now.
string
End of the date range (ISO 8601). Filters by publishedAt. Defaults to the current time.
string
Sort field. Allowed values: publishedAt, views, engagement. Defaults to publishedAt. views and engagement sort by the aggregated totals.
string
Sort direction: asc or desc. Defaults to desc.
number
Number of items to return per page (1-100). Defaults to 25.
string
Cursor for pagination. Pass the nextCursor value from a previous response to fetch the next page of results.

Response

array
Array of publication objects
object
Cursor-based pagination metadata

Error Responses

object
object
object
object