List Articles

GET

articles

List Articles

curl --request GET \
  --url https://api.example.com/articles

import requests

url = "https://api.example.com/articles"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://api.example.com/articles', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/articles",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/articles"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.example.com/articles")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/articles")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

Endpoints

GET /articles
GET /posts                                 # backward-compatible alias
GET /collections/:collection-slug/items    # for specific enabled collections

Plan note:

Articles are available on all plans.
Additional non-article collections require the Authority plan.

Query parameters

Parameter	Type	Default	Description
`page`	integer	`1`	Page number
`per_page`	integer	`10`	Items per page (max `100`)
`offset`	integer	-	Zero-based item offset; overrides the offset derived from `page`
`status`	string	`published`	Status filter (`published`, `draft`, `scheduled`, `all`)
`search`	string	-	Search in title, excerpt, content, slug, canonical URL, or external URL
`categories`	string	-	Comma-separated category IDs
`tags`	string	-	Comma-separated tag IDs
`authors`	string	-	Comma-separated author IDs
`orderby`	string	`date`	Sort field (`date`, `publish_at`, `created_at`, `updated_at`, `title`, `slug`, `id`)
`order`	string	`desc`	Sort direction (`asc`, `desc`)
`_fields`	string	-	Comma-separated list of response attributes to return
`include`	string	-	Include related resources (`categories,tags,authors`)

Example request (root articles)

curl "https://api.skayle.ai/v1/ORG_ID/articles?status=published&page=1&per_page=2&include=categories,tags,authors&orderby=date&order=desc"

To retrieve a custom slice ordered by its public publishing date:

curl "https://api.skayle.ai/v1/ORG_ID/articles?status=published&offset=10&per_page=12&orderby=publish_at&order=desc"

To find an article by its slug or a full URL:

curl "https://api.skayle.ai/v1/ORG_ID/articles?search=https%3A%2F%2Fexample.com%2Fblog%2Fb2b-saas-content-strategy-2026"

Example request (collection items)

curl "https://api.skayle.ai/v1/ORG_ID/collections/answers/items?status=published&page=1&per_page=20"

Example response

{
  "data": [
    {
      "id": "post_01HZX2...",
      "type": "articles",
      "attributes": {
        "title": "B2B SaaS Content Strategy for 2026",
        "slug": "b2b-saas-content-strategy-2026",
        "excerpt": "A practical framework for demand capture and category coverage.",
        "content": "...",
        "content_html": "<h2>...</h2>",
        "comparison_screenshots": [
          {
            "section_heading": "Acme vs Competitor A",
            "section_slug": "acme-vs-competitor-a",
            "competitor_name": "Competitor A",
            "source_url": "https://competitor-a.com/",
            "screenshot_url": "https://cdn.example.com/comparison-screenshots/org/post/acme-vs-competitor-a.webp",
            "captured_at": "2026-02-25T13:02:11.000Z",
            "status": "captured"
          }
        ],
        "status": "published",
        "word_count": 1860,
        "seo_title": "B2B SaaS Content Strategy for 2026",
        "meta_description": "Framework for planning and publishing ranking-focused content.",
        "featured_image_url": "https://cdn.example.com/hero.jpg",
        "faq": [],
        "schema_json_ld": {},
        "publish_at": "2026-02-01T00:00:00.000Z",
        "created_at": "2026-01-28T12:15:01.000Z",
        "updated_at": "2026-02-01T09:20:11.000Z",
        "edited_at": null
      },
      "relationships": {
        "categories": {
          "data": [{ "type": "categories", "id": "cat_01HZX..." }]
        },
        "tags": {
          "data": [{ "type": "tags", "id": "tag_01HZX..." }]
        },
        "authors": {
          "data": [{ "type": "authors", "id": "author_01HZX..." }]
        }
      },
      "links": {
        "self": "/v1/ORG_ID/articles/post_01HZX2..."
      }
    }
  ],
  "included": [
    {
      "id": "cat_01HZX...",
      "type": "categories",
      "attributes": {
        "name": "Content Strategy",
        "slug": "content-strategy"
      }
    }
  ],
  "links": {
    "self": "/v1/ORG_ID/articles?page=1&per_page=2",
    "prev": null,
    "next": "/v1/ORG_ID/articles?page=2&per_page=2"
  },
  "meta": {
    "total": 42,
    "per_page": 2,
    "page": 1
  }
}

Notes

status defaults to published for list requests.
status=scheduled is supported.
Legacy scheduled rows represented as draft + publish_at are returned as scheduled.
status=draft excludes those legacy scheduled rows.
categories, tags, and authors filters are ID-based.
/posts is backward-compatible, but new integrations should use /articles.

Response field descriptions

Field	Type	Description
`data[].id`	string	Unique article/item ID
`data[].type`	string	Resource type (`articles` for root feed, `items` for non-article collections)
`data[].attributes.title`	string	Content title
`data[].attributes.slug`	string	URL slug
`data[].attributes.excerpt`	string \| null	Short summary
`data[].attributes.content`	string	Main content body
`data[].attributes.content_html`	string \| null	Rendered HTML content
`data[].attributes.comparison_screenshots`	array	Competitor screenshot metadata for comparison sections
`data[].attributes.status`	string	Content status
`data[].attributes.word_count`	number \| null	Word count
`data[].attributes.faq`	array	FAQ items
`data[].attributes.schema_json_ld`	object \| null	JSON-LD schema payload
`data[].attributes.created_at`	string	ISO datetime
`data[].attributes.updated_at`	string	ISO datetime
`data[].relationships`	object	Linked category/tag/author references
`included[]`	array	Included resources requested by `include`
`meta.total`	number	Total matching rows
`meta.per_page`	number	Page size
`meta.page`	number	Current page

Filtering behavior

search matches title, excerpt, content, slug, canonical URL, and external URL.
A full URL also searches its decoded final path segment, allowing it to match a stored slug when the title differs.
categories, tags, and authors accept comma-separated IDs.
Multiple taxonomy filters are combined so results match all active filter groups.
Comparison posts may include embedded screenshot images in content_html and structured screenshot metadata in comparison_screenshots.

Pagination

Pagination metadata is returned in meta and navigation links in links. Use page and per_page to page through results. Use offset with per_page when the first page and later pages have different sizes. offset takes precedence over the offset calculated from page.

Error responses

Organization not found

{
  "errors": [
    {
      "status": "404",
      "title": "Not Found",
      "detail": "Organization with ID \"ORG_ID\" not found"
    }
  ]
}

API not available for this connector mode

{
  "errors": [
    {
      "status": "403",
      "title": "Forbidden",
      "detail": "This organization's content is not available via API. Skayle CMS mode must be enabled."
    }
  ]
}

Collection not found or disabled

{
  "errors": [
    {
      "status": "404",
      "title": "Not Found",
      "detail": "Collection not found or not enabled"
    }
  ]
}

Get Article / ItemRetrieve a single article or collection item by ID or slug.

List Articles

curl --request GET \
  --url https://api.example.com/articles

import requests

url = "https://api.example.com/articles"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://api.example.com/articles', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/articles",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/articles"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.example.com/articles")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/articles")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

API Overview

Agent API and MCP

Skayle CMS Content API

Collections

Articles

Taxonomies

Media

Endpoints

Query parameters

Example request (root articles)

Example request (collection items)

Example response

Notes

Response field descriptions

Filtering behavior

Error responses

Organization not found

API not available for this connector mode

Collection not found or disabled

​Endpoints

​Query parameters

​Example request (root articles)

​Example request (collection items)

​Example response

​Notes

​Response field descriptions

​Filtering behavior

​Pagination

​Error responses

​Organization not found

​API not available for this connector mode

​Collection not found or disabled

Endpoints

Query parameters

Example request (root articles)

Example request (collection items)

Example response

Notes

Response field descriptions

Filtering behavior

Pagination

Error responses

Organization not found

API not available for this connector mode

Collection not found or disabled