sangtao.ai
API key

Publishing

List posts

Your posts, newest first, filtered by group, status, date or title.

GEThttps://api.sangtao.ai/v2/publishing/posts

Authorization

  • X-Api-Keystring · headerrequired

    Your API key, from the API keys page of your account.

Query parameters

  • teamIdstring (guid)

    Only this group's posts

  • statusstring

    Only posts in this status, case-insensitive. An unknown value is ignored

    Available options:PendingProcessingDraftUploadingScheduledPublishingPublishedPartiallyPublishedFailedCancelled

  • fromstring

    Created at or after (ISO 8601)

  • tostring

    Created at or before (ISO 8601)

  • searchstring

    Text the post title contains

  • pagenumber

    Page number, from 1. Default 1

  • pageSizenumber

    Posts per page, 1–50. Default 20

Response

  • totalnumberrequired

    Posts matching the filters, across all pages

  • pagenumberrequired

    This page

  • pageSizenumberrequired

    Posts per page, after the 1–50 limit

  • itemsobject[]required

    The posts, newest first — fields as in Get a post, except platforms[] carries no caption, title or description

GET/publishing/posts
curl "https://api.sangtao.ai/v2/publishing/posts?teamId=3fa85f64-5717-4562-b3fc-2c963f66afa6&status=PartiallyPublished&page=1&pageSize=20" \
  -H "X-Api-Key: YOUR_API_KEY"
{
  "success": true,
  "data": {
    "total": 1,
    "page": 1,
    "pageSize": 20,
    "items": [
      {
        "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "teamId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "teamName": "Main channels",
        "webJobId": null,
        "title": "How to make iced coffee at home",
        "thumbnailUrl": "https://cdn.example.com/cover.jpg",
        "status": "PartiallyPublished",
        "statusMessage": null,
        "scheduledAt": null,
        "createdAt": "2026-11-08T02:00:00Z",
        "platforms": [
          {
            "id": "pp_3kT9qPz0B",
            "platform": "TikTok",
            "postType": null,
            "status": "Published",
            "externalUrl": "https://www.tiktok.com/@yourchannel/video/1234567890",
            "error": null,
            "publishedAt": "2026-11-08T02:03:00Z"
          },
          {
            "id": "pp_9pW4nKt1H",
            "platform": "YouTube",
            "postType": "SHORT",
            "status": "Failed",
            "externalUrl": null,
            "error": "The video is too long for Shorts",
            "publishedAt": null
          }
        ]
      }
    ]
  }
}