XPlanner

Docs

Fikirleri listele

Returns the idea repository as a paginated list. Active ideas are returned by default; use status to select the archive view.


GET

/ideas

ideas:read

Header'lar

Authorization

*
string

API key. Format: Bearer xpl_live_...

Query parametreleri

socialSetId

string

Narrows results to one Social Set id.

folderId

string | null

Specific folder id. For ideas without folders, send folderId=null.

status

active | archived | all

active returns active ideas only, archived returns archived ideas only, and all returns both. The default is active.

limit

integer

Number of records per page. Default is 50, maximum is 100.

cursor

string

The pagination.nextCursor value from the previous answer.

folder filter

folderId yok

all

It lists the ideas accessible by the API key without distinguishing between folders.

folderId=null

without folder

It only returns ideas that are not bound to the folder. The empty folderId value is also interpreted as null.

folderId=fld_123

single folder

It only lists ideas linked to the given folder.

sıralama

createdAt desc

Results are sorted by creation date, newest to oldest.

Cevaplar

200

Paged list of ideas.

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"}