/api/v4/social/bulk-posts/{bulkJobId}Sammelauftrag für Beiträge abrufen
Gibt den Status, die Zählerstände und die Ergebnisse pro Zeile eines Sammelauftrags für Social-Media-Beiträge zurück.
Parameter
Pfad
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| bulkJobId | string | erforderlich | Job UUID, the `job.id` returned by POST /social/bulk-posts. |
Antworten
200The job with its counts and one entry per submitted row.
{ "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`).
Liefert Informationen zu einem Auftrag, der mit POST /social/bulk-posts erstellt wurde. Fragen Sie ihn wiederholt ab, bis status einen Endwert erreicht, und lesen Sie anschließend results[], um das Ergebnis jeder Zeile zu erfahren.
Anwendungsfall: einen Massenimport mit Ihrem eigenen Kalender abgleichen. Fragen Sie diesen Endpunkt nach dem Einreichen eines Batches alle paar Sekunden ab. Wenn status einen Endzustand erreicht hat, durchlaufen Sie results[], ordnen Sie den Wert von clientReference jedes Eintrags Ihrem eigenen Datensatz zu und schreiben Sie socialPostId in diesen Datensatz. Zeilen mit status: "FAILED" enthalten den Grund in errors[]; senden Sie nur diese Zeilen erneut in einem neuen Batch.
Anwendungsfall: ein Fortschrittsbalken. processedCount im Verhältnis zu totalCount reicht aus, um einen Fortschrittsbalken anzuzeigen, ohne results[] überhaupt zu durchlaufen, und successCount / failureCount liefern Ihnen die Zusammenfassung, sobald der Auftrag abgeschlossen ist.
Auftragsstatus
Hinweise.
clientReferencegibt unverändert den Wert zurück, den Sie in dieser Zeile gesendet haben. Dies ist die eindeutigste Verknüpfung mit Ihren eigenen Daten;index, die bei 0 beginnende Position der Zeile im von Ihnen eingereichten Array, dient als Ersatz, wenn Sie keinen Wert gesendet haben.- Wenn eine Zeile
status: "CREATED"erreicht, bedeutet dies, dass der Beitrag existiert, nicht dass er veröffentlicht wurde —postStatuszeigt Ihnen den aktuellen Zustand des Beitrags selbst. Zeilen mitPUBLISHundSCHEDULEdurchlaufen anschließend weiterhin die asynchrone Veröffentlichungspipeline: Verwenden Sie jeden Wert vonsocialPostIdbeiGET /social/posts/{postId}und lesen Siechannels[], um das tatsächliche Ergebnis pro Kanal zu erfahren. - Ein Auftrag, bei dem die Validierung aller Zeilen fehlgeschlagen ist, wäre gar nicht erst erstellt worden, da Massenerstellung den Batch vor dem Einreihen in die Warteschlange ablehnt. Ein Auftrag mit
FAILEDbedeutet hier, dass der Auftrag nach seiner Annahme fehlgeschlagen ist. updatedAtändert sich während der Verarbeitung der Zeilen; der Wert steht fest, sobald der Auftrag einen Endzustand erreicht hat.
curl -X GET 'https://listingsapi.com/api/v4/social/bulk-posts/<bulkJobId>' \ -H "Authorization: API $LISTINGSAPI_KEY"