> ## Documentation Index
> Fetch the complete documentation index at: https://snowseo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Articles

> List all articles for your team with status, SEO scores, and metadata.

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.

<Note>
  This endpoint returns article metadata only (no full body content). Use the individual article endpoint to fetch the full content.
</Note>

### Fields

| Field        | Description                                                                                          |
| ------------ | ---------------------------------------------------------------------------------------------------- |
| `status`     | Current status: `draft`, `processing`, `generated`, `scheduled`, `published`, `failed`               |
| `type`       | Article type: `news`, `blog`, `guide`, `review`, `comparison`, `technical`, `case-study`, `listicle` |
| `auditScore` | SEO audit score (0–100), from the article's latest audit                                             |
| `isPublic`   | Whether the article is publicly accessible via your brand feed                                       |
| `isPillar`   | Whether this is a pillar (cornerstone) article                                                       |
| `keywords`   | Target keywords with type (`primary` / `secondary`)                                                  |
| `provider`   | CMS provider(s) if published (`wordpress`, `shopify`, `webflow`, `ghost`, `webhook`, `framer`)       |


## OpenAPI

````yaml GET /v3/cms/articles
openapi: 3.0.0
info:
  title: SnowSEO API
  description: API documentation for SnowSEO
  version: 1.0.0
servers:
  - url: https://api.snowseo.com
    description: Production server
security: []
tags:
  - name: Keywords
    description: Keyword research and suggestion end-points
  - name: Onboarding
    description: Brand onboarding and strategy end-points
  - name: Brands
    description: Brand management end-points
  - name: Organizations
    description: Organization and member end-points
  - name: Integrations
    description: Google Search Console and other integrations
  - name: Utilities
    description: Common utility end-points like screenshots and uploads
externalDocs:
  url: https://snowseo.com/docs
  description: Find more info here
paths:
  /v3/cms/articles:
    get:
      tags:
        - CMS
      summary: List articles
      description: >-
        Returns a paginated list of articles for the team with status, SEO
        scores, publish dates, and metadata. Does not include full article body
        content.
      parameters:
        - schema:
            type: string
          in: query
          name: teamId
          required: false
          description: Team ID
        - schema:
            type: string
          in: query
          name: page
          required: false
          description: 'Page number (default: 1)'
        - schema:
            type: string
          in: query
          name: per_page
          required: false
          description: 'Items per page (default: 20, or "all")'
        - schema:
            type: string
          in: query
          name: status
          required: false
          description: >-
            Filter by status (draft, generated, published, scheduled, failed) or
            "all"
        - schema:
            type: string
          in: query
          name: topicId
          required: false
          description: Filter to articles belonging to a topic cluster
        - schema:
            type: string
          in: query
          name: startDate
          required: false
          description: >-
            ISO date — only articles whose scheduledAt or publishedAt is
            on/after this (calendar-window scoping)
        - schema:
            type: string
          in: query
          name: endDate
          required: false
          description: >-
            ISO date — only articles whose scheduledAt or publishedAt is
            on/before this (calendar-window scoping)
        - schema:
            type: string
          in: query
          name: search
          required: false
          description: >-
            Case-insensitive search across title, slug, keywords, prompts,
            providers, and topic name
        - schema:
            type: string
          in: query
          name: sortBy
          required: false
          description: >-
            Sort column: name | status | seo | topic | created (default:
            created)
        - schema:
            type: string
          in: query
          name: sortDir
          required: false
          description: 'Sort direction: asc | desc (default: desc)'
        - schema:
            type: string
          in: query
          name: category
          required: false
          description: Filter to articles carrying this category name
        - schema:
            type: string
          in: query
          name: tag
          required: false
          description: Filter to articles carrying this tag name
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  articles:
                    type: array
                    items:
                      type: object
                      properties:
                        slug:
                          type: string
                        topicId:
                          type: string
                          nullable: true
                        title:
                          type: string
                          nullable: true
                        status:
                          type: string
                          nullable: true
                          enum:
                            - draft
                            - processing
                            - generated
                            - scheduled
                            - published
                            - failed
                        type:
                          type: string
                          nullable: true
                          enum:
                            - news
                            - blog
                            - guide
                            - review
                            - comparison
                            - technical
                            - case-study
                            - listicle
                        keywords:
                          type: array
                          items:
                            type: object
                            properties:
                              keyword:
                                type: string
                              type:
                                type: string
                                enum:
                                  - primary
                                  - secondary
                        prompts:
                          type: array
                          items:
                            type: object
                            properties:
                              prompt:
                                type: string
                              type:
                                type: string
                                enum:
                                  - primary
                                  - secondary
                              topic:
                                type: string
                        auditScore:
                          type: number
                          nullable: true
                        url:
                          type: string
                          nullable: true
                        cmsArticleId:
                          type: string
                          nullable: true
                        provider:
                          type: array
                          nullable: true
                          items:
                            type: string
                            enum:
                              - wordpress
                              - shopify
                              - webflow
                              - ghost
                              - webhook
                              - framer
                        publishedAt:
                          type: string
                          nullable: true
                        scheduledAt:
                          type: string
                          nullable: true
                        lastRefreshedAt:
                          type: string
                          nullable: true
                        cmsPostStatus:
                          type: string
                          nullable: true
                          enum:
                            - draft
                            - published
                        createdAt:
                          type: string
                          nullable: true
                        updatedAt:
                          type: string
                          nullable: true
                        metaData:
                          type: object
                          nullable: true
                          additionalProperties: true
                        isPublic:
                          type: boolean
                          nullable: true
                        isPillar:
                          type: boolean
                          nullable: true
                        generating:
                          type: boolean
                        generationKind:
                          type: string
                          nullable: true
                        finalizing:
                          type: boolean
                        categories:
                          type: array
                          items:
                            type: string
                        tags:
                          type: array
                          items:
                            type: string
                  pagination:
                    type: object
                    properties:
                      page:
                        type: number
                      perPage:
                        type: number
                      total:
                        type: number
                      totalPages:
                        type: number
                      hasMore:
                        type: boolean
        '500':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string

````