/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.
socialSetId
Sonuçları tek Sosyal Sete daraltır. GET /social-sets 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 görünür ve hiçbir platforma 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 seçili platform hedeflerine iletilmek üzere işleme alınmıştır. Hedef sonuçlarını publishTargets alanından takip et.
pushed
Gönderinin seçili yayın hedefleri tamamlanmıştır. Platform sonuçları publishTargets içinde tutulur.
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
Eski X-only entegrasyonlarda sonuçları tek hesaba indirir.
socialSetId
Yeni çoklu platform entegrasyonlarında sonuçları tek Sosyal Sete indirir.
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&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"}