/ideas
ideas:read
Header'lar
Authorization
*API anahtarı. Format: Bearer xpl_live_...
Query parametreleri
socialSetId
Sonuçları tek Sosyal Set kimliğine daraltır.
folderId
Belirli klasör id'si. Klasörsüz fikirler için folderId=null gönder.
status
active yalnız aktif fikirleri, archived yalnız arşivi, all ise ikisini döndürür. Varsayılan active.
limit
Sayfa başına kayıt sayısı. Varsayılan 50, maksimum 100.
cursor
Önceki cevaptaki pagination.nextCursor değeri.
Klasör filtresi
folderId yok
API anahtarının erişebildiği fikirleri klasör ayrımı yapmadan listeler.
folderId=null
Yalnızca klasöre bağlı olmayan fikirleri döndürür. Boş folderId değeri de null gibi yorumlanır.
folderId=fld_123
Yalnızca verilen klasöre bağlı fikirleri listeler.
sıralama
Sonuçlar oluşturulma tarihine göre yeniden eskiye sıralanır.
Cevaplar
Sayfalanmış fikir listesi.
cURL
curl "https://api.xplanner.co/v1/ideas?socialSetId=set_123&folderId=fld_123&limit=20" \ -H "Authorization: Bearer $XPLANNER_API_KEY"Cevap
{ "data": [ { "id": "idea_123", "socialSetId": "set_123", "folderId": "fld_123", "title": "API lansmanı", "content": "Public API ile içerik akışını dış araçlara aç.", "isPinned": false, "archivedAt": null, "workspaceId": "wrk_123", "createdAt": "2026-05-15T09:00:00.000Z", "updatedAt": "2026-05-15T09:00:00.000Z" } ], "pagination": { "nextCursor": null }, "requestId": "req_123"}