Skip to main content
GET
/
v1
/
projects
/
published
curl -X GET "https://api.submagic.co/v1/projects/published?platform=youtube&limit=25" \
  -H "x-api-key: sk-your-api-key-here"

{
  "data": [
    {
      "id": "pub_8f3b4c2e-1a9d-4e5f-9b7c-2a4d6e8f1c3b",
      "projectId": "550e8400-e29b-41d4-a716-446655440000",
      "publishedAt": "2026-04-28T12:34:56.000Z",
      "scheduled": false,
      "status": "published",
      "project": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "title": "How I Doubled My Revenue in 30 Days"
      },
      "posts": [
        {
          "platform": "youtube",
          "platformPostId": "dQw4w9WgXcQ",
          "platformPostUrl": "https://youtube.com/watch?v=dQw4w9WgXcQ",
          "publishStatus": "published",
          "syncStatus": "synced",
          "error": null,
          "analytics": {
            "views": 1234,
            "likes": 56,
            "comments": 7,
            "shares": 2,
            "impressions": 5000,
            "reach": 800,
            "clicks": 120,
            "engagementRate": 0.125
          }
        }
      ]
    }
  ],
  "pagination": {
    "nextCursor": "eyJpZCI6InB1Yl83YjJjM2Q0ZSJ9"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.submagic.co/llms.txt

Use this file to discover all available pages before exploring further.

​
List Published Projects

Retrieve a paginated list of your published posts across YouTube, TikTok, and Instagram. Each entry includes per-platform delivery status, post URLs, and analytics where available.
This endpoint requires authentication.

​
Authentication

​
x-api-key
string
required
Your Submagic API key starting with sk-

​
Query Parameters

​
platform
string
Filter by platform. Allowed values: youtube, tiktok, instagram.
​
limit
number
Number of items to return per page (1-100). Defaults to 25.
​
cursor
string
Cursor for pagination. Pass the nextCursor value from a previous response to fetch the next page of results.

​
Response

​
data
array
Array of publication objects
​
pagination
object
Cursor-based pagination metadata
curl -X GET "https://api.submagic.co/v1/projects/published?platform=youtube&limit=25" \
  -H "x-api-key: sk-your-api-key-here"

{
  "data": [
    {
      "id": "pub_8f3b4c2e-1a9d-4e5f-9b7c-2a4d6e8f1c3b",
      "projectId": "550e8400-e29b-41d4-a716-446655440000",
      "publishedAt": "2026-04-28T12:34:56.000Z",
      "scheduled": false,
      "status": "published",
      "project": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "title": "How I Doubled My Revenue in 30 Days"
      },
      "posts": [
        {
          "platform": "youtube",
          "platformPostId": "dQw4w9WgXcQ",
          "platformPostUrl": "https://youtube.com/watch?v=dQw4w9WgXcQ",
          "publishStatus": "published",
          "syncStatus": "synced",
          "error": null,
          "analytics": {
            "views": 1234,
            "likes": 56,
            "comments": 7,
            "shares": 2,
            "impressions": 5000,
            "reach": 800,
            "clicks": 120,
            "engagementRate": 0.125
          }
        }
      ]
    }
  ],
  "pagination": {
    "nextCursor": "eyJpZCI6InB1Yl83YjJjM2Q0ZSJ9"
  }
}

​
Error Responses

​
400 Validation Error
object
{
  "error": "VALIDATION_ERROR",
  "message": "Request validation failed",
  "details": [
    {
      "field": "platform",
      "message": "Must be one of: youtube, tiktok, instagram",
      "value": "facebook"
    }
  ]
}
​
401 Unauthorized
object
{
  "error": "UNAUTHORIZED",
  "message": "Invalid or missing API key"
}
​
429 Rate Limited
object
{
  "error": "RATE_LIMIT_EXCEEDED",
  "message": "Too many requests",
  "retryAfter": 30
}
​
500 Server Error
object
{
  "error": "INTERNAL_SERVER_ERROR",
  "message": "An unexpected error occurred"
}