Skip to main content
GET
/
v1
/
posts
/
{postId}
curl "https://api.infinipost.co/v1/posts/post_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "postId": "post_abc123",
  "accountId": "acc_1a2b3c4d5e",
  "platform": "tiktok",
  "contentType": "video",
  "contentUrl": "https://storage.googleapis.com/...",
  "thumbnailUrl": "https://storage.googleapis.com/.../thumb.jpg",
  "caption": "Check out this amazing content! #viral",
  "soundId": "snd_xyz789",
  "timezone": "America/New_York",
  "scheduledTime": "2024-04-22T16:00:00Z",
  "status": "scheduled",
  "postedAt": null,
  "createdAt": "2024-04-21T20:15:00Z"
}

​
Path Parameters

​
postId
string
required
The unique post identifier.

​
Response

​
postId
string
Unique identifier for the post.
​
accountId
string
The account this post is scheduled for.
​
platform
string
Platform: tiktok or instagram.
​
contentType
string
video or slides.
​
contentUrl
string | array
The content to be posted. When contentType is video, this is a single URL string. When contentType is slides, this is an array of image URL strings.
​
thumbnailUrl
string
URL of the video thumbnail. null for slideshow posts or if not yet generated.
​
caption
string
Post caption.
​
soundId
string
ID of the sound attached to this post. null if no sound.
​
timezone
string
IANA timezone the scheduledTime was submitted in (e.g. America/New_York).
​
scheduledTime
string
UTC ISO 8601 timestamp of when the post is scheduled to go live.
​
status
string
Current status: generated, pending_render, posted, or failed.
​
postedAt
string
ISO 8601 timestamp of when the post went live. null if not yet posted.
​
createdAt
string
ISO 8601 timestamp of when the post was created.
curl "https://api.infinipost.co/v1/posts/post_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "postId": "post_abc123",
  "accountId": "acc_1a2b3c4d5e",
  "platform": "tiktok",
  "contentType": "video",
  "contentUrl": "https://storage.googleapis.com/...",
  "thumbnailUrl": "https://storage.googleapis.com/.../thumb.jpg",
  "caption": "Check out this amazing content! #viral",
  "soundId": "snd_xyz789",
  "timezone": "America/New_York",
  "scheduledTime": "2024-04-22T16:00:00Z",
  "status": "scheduled",
  "postedAt": null,
  "createdAt": "2024-04-21T20:15:00Z"
}

​
Error Responses

Unauthorized
{
  "error": {
    "code": "unauthenticated",
    "message": "Invalid or missing API key"
  }
}
Post Not Found
{
  "error": {
    "code": "not_found",
    "message": "Post post_abc123 not found"
  }
}
Server Error
{
  "error": {
    "code": "internal",
    "message": "An unexpected error occurred"
  }
}