GET
/folders
folders:read
Header'lar
Authorization
*string
API key. Format: Bearer xpl_live_...
Query parametreleri
socialSetId
string
Narrows results to one Social Set id.
query
string
Search by folder name. Maximum 120 characters.
limit
integer
Number of records per page. Default is 50, maximum is 100.
cursor
string
The pagination.nextCursor value from the previous answer.
Listing behavior
socialSetId
opsiyonel
When provided, results are narrowed to one Social Set. Otherwise, folders from all accessible Social Sets are returned.
query
contains
It performs a case-insensitive search in the folder name. A maximum of 120 characters is accepted.
sıralama
createdAt desc
Results are sorted by creation date, newest to oldest.
The folder list uses cursor pagination and narrows the results based on the reach of the API key.
Cevaplar
200
Paged folder list.
404
socialSetId was not found or the key does not have access.
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"}