Skip to main content

Adapto CMS Public API Documentation

Complete developer reference for the Adapto CMS Public API. All endpoints are read-only and require an API key for authentication.

Base URL: https://api.adaptocms.com

Getting Started

Page

Description

Introduction

Overview of Adapto CMS, the Public API, quick start guide, and available resources.

Authentication

How to obtain and use your API key, security best practices, and authentication errors.

Pagination, Sorting & Filtering

Common query parameters for pagination, sorting, filtering, and preview endpoints.

API Reference

Page

Endpoints

Description

Articles API

5 endpoints

List, get by ID/slug, previews, and translations for blog posts and long-form content.

Categories API

6 endpoints

List, get by ID/slug, subcategories, articles in category, and translations.

Pages API

4 endpoints

List, get by ID/slug, previews for static pages with hierarchical structure.

Custom Collections API

7 endpoints

List collections, get by ID/slug, list/get items by ID/slug, item previews.

Micro Copy API

6 endpoints

List, get by ID/key/language, count, and translations for UI text snippets.

Search API

1 endpoint

Full-text search across articles, pages, and collection items.

Available Languages API

1 endpoint

List all languages with published content.

Reference

Page

Description

Data Models

Complete reference for all response models, field types, and schema definitions.

Error Handling

HTTP status codes, validation errors, rate limiting, and error handling best practices.

All Public Endpoints at a Glance

Method

Endpoint

Description

GET

/public/articles

List articles

GET

/public/articles/preview

List article previews

GET

/public/articles/{id}

Get article by ID

GET

/public/articles/by-slug/{slug}

Get article by slug

GET

/public/articles/{id}/translations

Get article translations

GET

/public/categories

List categories

GET

/public/categories/{id}

Get category by ID

GET

/public/categories/by-slug/{slug}

Get category by slug

GET

/public/categories/{id}/subcategories

Get subcategories

GET

/public/categories/{id}/articles

Get articles in category

GET

/public/categories/{id}/translations

Get category translations

GET

/public/pages

List pages

GET

/public/pages/preview

List page previews

GET

/public/pages/{id}

Get page by ID

GET

/public/pages/by-slug/{slug}

Get page by slug

GET

/public/custom-collections

List collections

GET

/public/custom-collections/{id}

Get collection by ID

GET

/public/custom-collections/by-slug/{slug}

Get collection by slug

GET

/public/custom-collections/{id}/items

List collection items

GET

/public/custom-collections/{id}/items/preview

List item previews

GET

/public/custom-collections/{id}/items/{item_id}

Get item by ID

GET

/public/custom-collections/{id}/items/by-slug/{slug}

Get item by slug

GET

/public/micro-copy

List micro copy

GET

/public/micro-copy/{id}

Get micro copy by ID

GET

/public/micro-copy/by-key/{key}

Get micro copy by key

GET

/public/micro-copy/language/{lang}

Get micro copy by language

GET

/public/micro-copy/count

Count micro copy entries

GET

/public/micro-copy/translations/{id}

Get micro copy translations

GET

/public/search

Full-text search

GET

/public/available-languages

Get available languages