CMS

List CMS posts

Retrieve CMS posts for a site with optional filtering by status and type.

get/cms/posts

Request

  • Base URL: https://next.frase.io/api/v1
  • URL: https://next.frase.io/api/v1/cms/posts
  • Auth: one of:
    • API key in header X-API-KEY
    • HTTP bearer

Query parameters

site_idstring uuid required

Site ID

status'draft' | 'published' | 'scheduled'
type'blog_post' | 'page'
sort'created_at' | 'published_at' | 'demand'

Ordering. demand orders posts by the site's own visitor-question demand (highest first), with published_at as tiebreak; posts with no demand signal sort last. Default created_at (descending).

pageinteger
page_sizeinteger

Response

Paginated list of CMS posts

Example response

{
  "data": [
    {
      "schema_markup": {
        "@context": "https://schema.org",
        "@type": "BlogPosting",
        "headline": "How to Optimize Content for SEO",
        "description": "A comprehensive guide to on-page SEO optimization.",
        "author": {
          "@type": "Person",
          "name": "Jane Smith",
          "url": "https://example.com/jane"
        },
        "publisher": {
          "@type": "Organization",
          "name": "Acme Inc.",
          "logo": {
            "@type": "ImageObject",
            "url": "https://example.com/logo.png"
          }
        },
        "datePublished": "2026-04-16",
        "dateModified": "2026-04-16",
        "image": "https://example.com/images/seo-guide.jpg"
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.