Skip to main content
GET
/
v1
/
projects
/
published
/
{id}
curl -X GET "https://api.submagic.co/v1/projects/published/pub_8f3b4c2e-1a9d-4e5f-9b7c-2a4d6e8f1c3b" \
  -H "x-api-key: sk-your-api-key-here"

{
  "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"
  },
  "totals": {
    "views": 1234,
    "engagement": 65,
    "followersGained": 18
  },
  "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
      }
    }
  ]
}

​
Get Publication

Retrieve one publication by its publication id — the id returned by List Published Projects. A publication represents one publish event for a project and contains a posts array with one entry per platform. The response includes per-platform delivery status, post URLs, analytics, and a totals rollup aggregated across those posts.
This endpoint requires authentication.
The {id} is the publication id (the id field from List Published Projects), not a project id. A single project can be published multiple times, so each publication has its own id. The projectId is still returned for linking back to the underlying project.

​
Authentication

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

​
Path Parameters

​
id
string
required
The unique identifier (UUID) of the publication to retrieve

​
Response

​
id
string
Unique identifier of the publication
​
projectId
string
The unique identifier of the underlying project
​
publishedAt
string
ISO 8601 timestamp of when the publication was published or is scheduled to publish
​
scheduled
boolean
true if the publication was scheduled for a future time
​
status
string
Overall publication status: published, scheduled, processing, or failed
​
project
object
Minimal project metadata
​
totals
object
Metrics aggregated across the publication’s platforms
​
posts
array
Array of per-platform post objects
curl -X GET "https://api.submagic.co/v1/projects/published/pub_8f3b4c2e-1a9d-4e5f-9b7c-2a4d6e8f1c3b" \
  -H "x-api-key: sk-your-api-key-here"

{
  "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"
  },
  "totals": {
    "views": 1234,
    "engagement": 65,
    "followersGained": 18
  },
  "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
      }
    }
  ]
}

​
Error Responses

​
404 Not Found
object
{
  "error": "NOT_FOUND",
  "message": "Publication not found"
}
​
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"
}