/posts
posts:read
Header'lar
Authorization
*API key. Format: Bearer xpl_live_...
Query parametreleri
status
Filters by post status. Valid values are listed in the Status values section.
workspaceId
Sonuçları tek Workspace'e daraltan opsiyonel guard.
socialSetId
Narrows results to one Social Set. Use the id from GET /social-sets.
sourceIdeaId
Narrows results to posts generated from the source idea identified by sourceIdeaId.
limit
Number of records per page. Default is 50, maximum is 100.
cursor
The pagination.nextCursor value from the previous answer.
Status values
draft_unscheduled
A draft without a scheduled date. It appears in the app and is not sent to any platform.
draft_scheduled
It is the draft status that carries plan information.
scheduled
A post that has a scheduled publication time or is queued for immediate publication.
processing
The post is being processed for its selected platform targets. Track target results in publishTargets.
pushed
The post's selected publish targets are complete. Platform results are stored in publishTargets.
failed
The publishing attempt could not be completed. Error details are reviewed in the shipment record within the product.
canceled
The scheduled publish was canceled. Create a new post to publish again.
Listing behavior
socialSetId
Sonuçları tek Sosyal Sete indirir.
limit
Determines the number of records to return on a page. If not sent, the default page size is used.
cursor
It is not produced by hand. The same pagination.nextCursor value in the previous answer is sent to the next request.
sıralama
Results are sorted by creation date, newest to oldest.
Cevaplar
Paginated list of posts.
cURL
curl "https://api.xplanner.co/v1/posts?status=scheduled&socialSetId=set_123&limit=10" \ -H "Authorization: Bearer $XPLANNER_API_KEY"Cevap
{ "data": [ { "id": "post_123", "status": "scheduled", "title": "Haftalık güncelleme", "text": "Bu hafta ürün tarafında şunları çözdük...", "scheduledAt": "2026-05-20T09:00:00.000Z", "media": [], "mediaRefs": [], "mediaMetadata": [], "xPostId": null, "createdAt": "2026-05-15T09:00:00.000Z", "updatedAt": "2026-05-15T09:00:00.000Z" } ], "pagination": { "nextCursor": null }, "requestId": "req_123"}