/posts
posts:read
Header'lar
Authorization
*API anahtarı. Format: Bearer xpl_live_...
Query parametreleri
status
Gönderi durumuna göre filtreler. Geçerli değerler Status değerleri bölümünde listelenmiştir.
accountId
Sonuçları tek XPlanner hesap id'sine daraltır. GET /accounts cevabındaki id alanından alınır.
limit
Sayfa başına kayıt sayısı. Varsayılan 50, maksimum 100.
cursor
Önceki cevaptaki pagination.nextCursor değeri.
Durum değerleri
draft_unscheduled
Plan tarihi olmayan taslak gönderidir. Panelde taslak olarak görünür ve X'e gönderilmez.
draft_scheduled
Plan bilgisi taşıyan taslak durumudur.
scheduled
Yayın zamanı belirlenmiş veya anında yayın için sıraya alınmış gönderidir.
processing
Gönderi X'e iletilmek üzere işleme alınmıştır. Güncel sonucu listeyi tekrar okuyarak takip et.
pushed
Gönderi X'e başarıyla iletilmiştir. Paneldeki yayınlanmış durumunun API karşılığıdır.
failed
Yayınlama denemesi tamamlanamamıştır. Hata ayrıntısı ürün içindeki gönderi kaydında incelenir.
canceled
Planlı yayın iptal edilmiştir. Tekrar yayınlamak için yeni gönderi oluşturmak gerekir.
Listeleme davranışı
accountId
Verilirse sonuçlar tek hesaba iner. Verilmezse API anahtarının erişebildiği tüm hesapların gönderileri döner.
limit
Bir sayfada dönecek kayıt sayısını belirler. Gönderilmezse varsayılan sayfa boyutu kullanılır.
cursor
Elle üretilmez. Önceki cevap içindeki pagination.nextCursor değeri aynen sonraki isteğe gönderilir.
sıralama
Sonuçlar oluşturulma tarihine göre yeniden eskiye sıralanır.
Cevaplar
Sayfalanmış gönderi listesi.
cURL
curl "https://api.xplanner.co/v1/posts?status=scheduled&accountId=acc_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"}