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