Listings APIListings API
登录
GET/api/v4/social/bulk-posts/{bulkJobId}

获取批量帖子任务

返回批量社交帖子任务的状态、计数和逐行结果。

需要 API 密钥。请求头格式和密钥轮换请参阅身份验证。

参数

路径

名称类型必填描述
bulkJobIdstring必填Job UUID, the `job.id` returned by POST /social/bulk-posts.

响应

200The job with its counts and one entry per submitted row.
Response
{  "data": {    "getBulkSocialPostJob": {      "id": "9b3f18d0-7a26-4c51-8e94-1f0d5c6b7a82",      "status": "COMPLETED_WITH_ERRORS",      "totalCount": 3,      "processedCount": 3,      "successCount": 2,      "failureCount": 1,      "createdAt": "2026-09-28T14:04:52Z",      "updatedAt": "2026-09-28T14:05:31Z",      "results": [        {          "index": 0,          "clientReference": "campaign-4471-slot-01",          "socialProfileId": "6f2c9a41-7b0e-4d55-9a2f-3c8e1d47b902",          "platforms": ["INSTAGRAM", "FACEBOOK"],          "status": "CREATED",          "socialPostId": "c47a1e58-2b93-4f10-a6d7-58e0c9b12345",          "postStatus": "SCHEDULED",          "errors": []        },        {          "index": 1,          "clientReference": "campaign-4471-slot-02",          "socialProfileId": "6f2c9a41-7b0e-4d55-9a2f-3c8e1d47b902",          "platforms": ["INSTAGRAM", "FACEBOOK", "LINKEDIN"],          "status": "CREATED",          "socialPostId": "e08b2d97-6f14-4c22-b7a5-9d3e1f6c4a70",          "postStatus": "SCHEDULED",          "errors": []        },        {          "index": 2,          "clientReference": "campaign-4471-slot-03",          "socialProfileId": "a90f7c22-5db1-4e83-9f40-2b7c6a1e5d33",          "platforms": ["INSTAGRAM"],          "status": "FAILED",          "socialPostId": null,          "postStatus": null,          "errors": [            {              "message": "SY95045: No connected channel for INSTAGRAM on this brand",              "code": "SY95045",              "contextInfo": [{ "key": "platform", "value": "INSTAGRAM" }]            }          ]        }      ]    }  }}
401Unauthenticated, missing or invalid API key.
404No job with that ID on this account (`SY95047`).

返回由 POST /social/bulk-posts 创建的任务的状态。请轮询此端点，直到 status 达到终态值，然后读取 results[]，了解每一行的最终结果。

使用场景：将批量加载的结果同步回您自己的日历。 提交批次后，每隔几秒轮询一次此端点。当 status 处于终态时，遍历 results[]，将每个条目的 clientReference 与您自己的记录匹配，并将 socialPostId 写入该记录。带有 status: "FAILED" 的行会在 errors[] 中包含原因；请仅将这些行放入新批次重新发送。

使用场景：进度条。 只需将 processedCount 与 totalCount 对比即可显示进度条，完全无需遍历 results[]，而 successCount / failureCount 可在任务结束时立即为您提供概要结果。

任务状态

status是否为终态含义
QUEUED否已接受，尚未开始。results[] 可能为空。
PROCESSING否正在创建各行。results[] 会随着处理进度逐步填充。
COMPLETED是所有行均已创建。
COMPLETED_WITH_ERRORS是部分行已创建，部分行失败。请读取 failureCount 和每一行的 errors[]。
FAILED是任务本身无法运行。未创建任何行。

注意事项。

  • clientReference 会原样返回您在该行中发送的内容。这是关联您自己数据的最直接方式；如果您未发送该值，则可使用 index 作为备选，它表示该行在您提交的数组中从 0 开始的位置。
  • 某一行达到 status: "CREATED" 意味着帖子已存在，并不表示它已发布；postStatus 表示帖子本身所处的状态。PUBLISH 和 SCHEDULE 行之后仍会经过异步发布流程：用每个 socialPostId 调用 GET /social/posts/{postId}，并读取 channels[]，以获取各渠道的实际结果。
  • 如果所有行都未通过验证，任务根本不会被创建，因为 批量创建 会在批次进入队列之前将其拒绝。这里的 FAILED 任务表示任务在被接受后发生了故障。
  • updatedAt 会随着各行的处理而变化；任务进入终态后，该值便不再变化。
Request
curl -X GET 'https://listingsapi.com/api/v4/social/bulk-posts/<bulkJobId>' \  -H "Authorization: API $LISTINGSAPI_KEY"
Run in playground