List Posts

Retrieve a paginated list of your scheduled and posted content

GET /v1/posts

cURL

# 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"

Response

{
  "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"
}

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.

Show Post object properties

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.

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.

cURL

# 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"

Response

{
  "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"
  }
}