GET
/folders
folders:read
Header'lar
Authorization
*string
API anahtarı. Format: Bearer xpl_live_...
Query parametreleri
socialSetId
string
Sonuçları tek Sosyal Set kimliğine daraltır.
query
string
Klasör adına göre arama. En fazla 120 karakter.
limit
integer
Sayfa başına kayıt sayısı. Varsayılan 50, maksimum 100.
cursor
string
Önceki cevaptaki pagination.nextCursor değeri.
Listeleme davranışı
socialSetId
opsiyonel
Verilirse sonuçlar tek Sosyal Set'e iner. Verilmezse erişilebilen tüm Sosyal Set'lerdeki klasörler döner.
query
contains
Klasör adında büyük/küçük harfe duyarsız arama yapar. En fazla 120 karakter kabul edilir.
sıralama
createdAt desc
Sonuçlar oluşturulma tarihine göre yeniden eskiye sıralanır.
Klasör listesi cursor pagination kullanır ve sonuçları API anahtarının erişim alanına göre daraltır.
Cevaplar
200
Sayfalanmış klasör listesi.
404
socialSetId bulunamadı veya anahtarın erişimi yok.
cURL
curl "https://api.xplanner.co/v1/folders?socialSetId=set_123&query=lansman&limit=10" \ -H "Authorization: Bearer $XPLANNER_API_KEY"Cevap
{ "data": [ { "id": "fld_123", "socialSetId": "set_123", "name": "Lansman fikirleri", "color": "blue", "isPinned": true, "order": 0, "workspaceId": "wrk_123", "createdAt": "2026-05-15T09:00:00.000Z", "updatedAt": "2026-05-15T09:00:00.000Z" } ], "pagination": { "nextCursor": null }, "requestId": "req_123"}