Skip to main content
GET
List articles
Get a paginated list of all articles for your team. This is the same data that powers the Content dashboard — article titles, statuses, SEO scores, publish dates, and more.
This endpoint returns article metadata only (no full body content). Use the individual article endpoint to fetch the full content.

Fields

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

teamId
string

Team ID

page
string

Page number (default: 1)

per_page
string

Items per page (default: 20, or "all")

status
string

Filter by status (draft, generated, published, scheduled, failed) or "all"

topicId
string

Filter to articles belonging to a topic cluster

startDate
string

ISO date — only articles whose scheduledAt or publishedAt is on/after this (calendar-window scoping)

endDate
string

ISO date — only articles whose scheduledAt or publishedAt is on/before this (calendar-window scoping)

Case-insensitive search across title, slug, keywords, prompts, providers, and topic name

sortBy
string

Sort column: name | status | seo | topic | created (default: created)

sortDir
string

Sort direction: asc | desc (default: desc)

category
string

Filter to articles carrying this category name

tag
string

Filter to articles carrying this tag name

Response

Default Response

articles
object[]
pagination
object