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. Query parameters: teamId, page (default 1), per_page (default 20, or all), status (any status below or all), topicId, startDate and endDate (match scheduledAt or publishedAt), search (title, slug, keywords, prompts, providers, topic name), sortBy (name, status, seo, topic, created, visitors; default created), sortDir (asc or desc; default desc), category, and tag. Limited to 30 requests per minute. Visitor counts need analyticsProvider set to the brand’s connected analytics integration (ga, posthog, plausible or snow), counted over analyticsStartDate and analyticsEndDate. Sorting by visitors without it returns 400. The response is { articles, summary, activity, pagination }:
  • summary counts the articles that match your filters: total, publishable (status generated or manual), unpublishable (published to a CMS), unschedulable (scheduled with a date), and byStatus (count per status).
  • activity.generating is the number of article generations currently running for your team.
  • pagination has page, pageSize, total, totalPages, and hasMore.
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

Your SnowSEO API key (sk_...).

Query Parameters

teamId
string

Team ID

selection
string

JSON all-matching or explicit article-slug selection, resolved only for bulk actions.

page
string

Page number (default: 1)

per_page
string

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

status
enum<string>

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

Available options:
draft,
processing,
generated,
scheduled,
published,
failed,
manual,
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
enum<string>
default:created

Sort column

Available options:
name,
status,
seo,
topic,
created,
visitors
sortDir
enum<string>
default:desc

Sort direction

Available options:
asc,
desc
analyticsProvider
enum<string>

Connected analytics integration to read page visitors from: ga (Google Analytics), posthog, plausible or snow (Snow Analytics). Without it, rows carry no visitor counts, and sorting by visitors returns 400.

Available options:
ga,
posthog,
plausible,
snow
analyticsStartDate
string<date>

Start of the visitor-count window, YYYY-MM-DD.

analyticsEndDate
string<date>

End of the visitor-count window, YYYY-MM-DD.

category
string

Filter to articles carrying this category name

tag
string

Filter to articles carrying this tag name

Response

Default Response

articles
object[]
summary
object
activity
object
pagination
object