Skip to main content
GET
List ideas

Authorizations

Authorization
string
header
required

API key authentication. Generate an API key from your workspace settings.

Query Parameters

limit
integer
default:20

Maximum number of ideas to return (1-100)

Required range: 1 <= x <= 100
cursor
string<uuid>

Cursor for pagination (idea ID from the last item of previous page)

ids

Fetch specific ideas by IDs

channel
enum<string>

Filter by channel

Available options:
LinkedIn,
Twitter,
TikTok,
YouTubeShorts
linkedInProfileId
string<uuid>

Filter by LinkedIn profile ID

xProfileId
string<uuid>

Filter by X/Twitter profile ID

tikTokProfileId
string<uuid>

Filter by TikTok profile ID

youTubeProfileId
string<uuid>

Filter by YouTube channel profile ID

labelIds

Filter by label IDs (ideas with any of these labels)

createdAtMin
string<date-time>

Filter ideas created on or after this date

createdAtMax
string<date-time>

Filter ideas created on or before this date

sortBy
enum<string>
default:createdAt

Field to sort by

Available options:
createdAt
sortOrder
enum<string>
default:desc

Sort order

Available options:
asc,
desc

Response

List of ideas

ideas
object[]
nextCursor
string | null

Cursor for the next page of results

hasMore
boolean

Whether there are more results