sangtao.ai
API key

Đăng bài

Danh sách bài đăng

Các bài đăng của bạn, mới nhất trước, lọc theo nhóm, trạng thái, ngày hoặc tiêu đề.

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

Xác thực

  • X-Api-Keystring · headerbắt buộc

    API key của bạn, tạo ở trang API key trong tài khoản.

Tham số query

  • teamIdstring (guid)

    Chỉ bài của nhóm này

  • statusstring

    Chỉ bài ở trạng thái này, không phân biệt hoa thường. Giá trị lạ thì bỏ qua

    Giá trị có thể:PendingProcessingDraftUploadingScheduledPublishingPublishedPartiallyPublishedFailedCancelled

  • fromstring

    Tạo từ thời điểm này (ISO 8601)

  • tostring

    Tạo đến thời điểm này (ISO 8601)

  • searchstring

    Chuỗi có trong tiêu đề bài

  • pagenumber

    Số trang, từ 1. Mặc định 1

  • pageSizenumber

    Số bài mỗi trang, 1–50. Mặc định 20

Response

  • totalnumberbắt buộc

    Tổng số bài khớp bộ lọc, mọi trang

  • pagenumberbắt buộc

    Trang hiện tại

  • pageSizenumberbắt buộc

    Số bài mỗi trang, sau khi giới hạn 1–50

  • itemsobject[]bắt buộc

    Các bài, mới nhất trước — trường như ở Lấy một bài đăng, riêng platforms[] không có caption, title, 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
          }
        ]
      }
    ]
  }
}