Skip to main content
GET
/
v1
/
posts
# First page
curl "https://api.infinipost.co/v1/posts?status=generated&limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Next page
curl "https://api.infinipost.co/v1/posts?status=generated&limit=50&cursor=cG9zdF9hYmMxMjM" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": [
    {
      "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": "generated",
      "postedAt": null,
      "createdAt": "2024-04-21T20:15:00Z"
    },
    {
      "postId": "post_def456",
      "accountId": "acc_1a2b3c4d5e",
      "platform": "instagram",
      "contentType": "slides",
      "contentUrl": [
        "https://storage.googleapis.com/.../slide1.jpg",
        "https://storage.googleapis.com/.../slide2.jpg",
        "https://storage.googleapis.com/.../slide3.jpg"
      ],
      "thumbnailUrl": null,
      "caption": "Step by step tutorial 🔥",
      "soundId": null,
      "timezone": "America/Los_Angeles",
      "scheduledTime": "2024-04-22T19:00:00Z",
      "status": "posted",
      "postedAt": "2024-04-22T19:00:12Z",
      "createdAt": "2024-04-21T20:15:00Z"
    }
  ],
  "hasMore": true,
  "nextCursor": "cG9zdF9hYmMxMjM"
}

Documentation Index

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

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

​
Query Parameters

​
status
string
Filter by post status: generated, pending_render, posted, or failed.
​
platform
string
Filter by platform: tiktok or instagram.
​
contentType
string
Filter by content type: video or slides.
​
accountId
string
Filter by a specific account ID.
​
limit
number
default:"50"
Number of posts to return (max 100).
​
cursor
string
Cursor for pagination. Pass the nextCursor value from the previous response to get the next page. Omit for the first page.

​
Response

​
data
array
Array of post objects.
​
hasMore
boolean
Whether there are more posts beyond this page.
​
nextCursor
string
Cursor to pass as the cursor query parameter to retrieve the next page. null when there are no more pages.
# First page
curl "https://api.infinipost.co/v1/posts?status=generated&limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Next page
curl "https://api.infinipost.co/v1/posts?status=generated&limit=50&cursor=cG9zdF9hYmMxMjM" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": [
    {
      "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": "generated",
      "postedAt": null,
      "createdAt": "2024-04-21T20:15:00Z"
    },
    {
      "postId": "post_def456",
      "accountId": "acc_1a2b3c4d5e",
      "platform": "instagram",
      "contentType": "slides",
      "contentUrl": [
        "https://storage.googleapis.com/.../slide1.jpg",
        "https://storage.googleapis.com/.../slide2.jpg",
        "https://storage.googleapis.com/.../slide3.jpg"
      ],
      "thumbnailUrl": null,
      "caption": "Step by step tutorial 🔥",
      "soundId": null,
      "timezone": "America/Los_Angeles",
      "scheduledTime": "2024-04-22T19:00:00Z",
      "status": "posted",
      "postedAt": "2024-04-22T19:00:12Z",
      "createdAt": "2024-04-21T20:15:00Z"
    }
  ],
  "hasMore": true,
  "nextCursor": "cG9zdF9hYmMxMjM"
}

​
Error Responses

Unauthorized
{
  "error": {
    "code": "unauthenticated",
    "message": "Invalid or missing API key"
  }
}
Invalid Parameter
{
  "error": {
    "code": "invalid_parameter",
    "message": "status must be one of: generated, pending_render, posted, failed"
  }
}
Invalid Cursor
{
  "error": {
    "code": "invalid_parameter",
    "message": "Invalid cursor"
  }
}
Server Error
{
  "error": {
    "code": "internal",
    "message": "An unexpected error occurred"
  }
}