Ghost Settings API
Settings provide access to global publication settings including title, description, navigation, and other configuration values.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/ghost-org-settings-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Ghost Content Settings API
description: The Ghost Content API is a RESTful, read-only API that delivers published content from a Ghost site to any client.
version: '5.0'
contact:
name: Ghost Foundation
url: https://ghost.org/docs/content-api/
termsOfService: https://ghost.org/terms/
servers:
- url: https://{site}.ghost.io/ghost/api/content
description: Ghost Pro Hosted Site
variables:
site:
default: your-site
description: Your Ghost site subdomain
- url: '{protocol}://{domain}/ghost/api/content'
description: Self-Hosted Ghost Instance
variables:
protocol:
default: https
enum:
- https
- http
domain:
default: localhost:2368
description: Your Ghost instance domain and port
security:
- contentApiKey: []
tags:
- name: Settings
description: Settings provide access to global publication settings including title, description, navigation, and other configuration values.
paths:
/settings/:
get:
operationId: readSettings
summary: Read settings
description: Retrieve all public settings for the Ghost publication, including title, description, logo, icon, cover image, language, timezone, navigation, and other site-wide configuration values.
tags:
- Settings
responses:
'200':
description: Publication settings
content:
application/json:
schema:
type: object
properties:
settings:
$ref: '#/components/schemas/Settings'
'401':
$ref: '#/components/responses/Unauthorized'
components:
schemas:
ErrorResponse:
type: object
description: Standard Ghost API error response
properties:
errors:
type: array
items:
type: object
properties:
message:
type: string
description: Human-readable error message
type:
type: string
description: Error type identifier
context:
type: string
description: Additional context about the error
nullable: true
Settings:
type: object
description: Global publication settings including identity, branding, navigation, and configuration.
properties:
title:
type: string
description: Publication title
description:
type: string
description: Publication description
logo:
type: string
format: uri
description: Publication logo URL
nullable: true
icon:
type: string
format: uri
description: Publication favicon URL
nullable: true
accent_color:
type: string
description: Publication accent color
nullable: true
pattern: ^#[0-9a-fA-F]{6}$
cover_image:
type: string
format: uri
description: Publication cover image URL
nullable: true
facebook:
type: string
description: Facebook page username
nullable: true
twitter:
type: string
description: Twitter account handle
nullable: true
lang:
type: string
description: Publication language code
timezone:
type: string
description: Publication timezone
codeinjection_head:
type: string
description: Global code injection in the head
nullable: true
codeinjection_foot:
type: string
description: Global code injection in the foot
nullable: true
navigation:
type: array
description: Primary navigation items
items:
$ref: '#/components/schemas/NavigationItem'
secondary_navigation:
type: array
description: Secondary navigation items
items:
$ref: '#/components/schemas/NavigationItem'
meta_title:
type: string
description: Global SEO meta title
nullable: true
meta_description:
type: string
description: Global SEO meta description
nullable: true
og_image:
type: string
format: uri
description: Default Open Graph image
nullable: true
og_title:
type: string
description: Default Open Graph title
nullable: true
og_description:
type: string
description: Default Open Graph description
nullable: true
twitter_image:
type: string
format: uri
description: Default Twitter card image
nullable: true
twitter_title:
type: string
description: Default Twitter card title
nullable: true
twitter_description:
type: string
description: Default Twitter card description
nullable: true
members_support_address:
type: string
format: email
description: Support email address for members
url:
type: string
format: uri
description: Site URL
NavigationItem:
type: object
description: A navigation menu item with a label and URL
properties:
label:
type: string
description: Display label for the navigation item
url:
type: string
description: URL the navigation item links to
required:
- label
- url
responses:
Unauthorized:
description: Authentication failed or API key is missing
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
securitySchemes:
contentApiKey:
type: apiKey
in: query
name: key
description: Content API key obtained from a custom integration in Ghost Admin. Content API keys are safe for use in browsers and other insecure environments as they only provide access to public data.
externalDocs:
description: Ghost Content API Documentation
url: https://ghost.org/docs/content-api/