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