Content Delivery API

Authentication

Authenticate your requests by including your Delivery API key in the Authorization header as a Bearer token. You can generate an API key in your Project Settings.

curl -X GET "https://api.sitelift.io/v1/delivery/articles" \
  -H "Authorization: Bearer sl_live_your_api_key_here"

Endpoints

List Articles

Returns a paginated list of articles with their metadata only: id, title, slug, featuredImageUrl, seoMeta, language, status, tags, createdAt and updatedAt. Bodies are not included so a list stays small enough to cache; fetch a single article for its content.

Query Parameters

Get Article by ID or Slug

Returns the full article payload, including the HTML body and SEO metadata. The :identifier can be either the Article UUID or the URL slug. Slug lookups only return published articles, so a site that renders whatever this endpoint returns can never expose a draft. UUID lookups (ids come from the authenticated list) and publish=true work for any status.

Query Parameters

{
  "id": "art_123456789",
  "title": "10 Best Dog Training Tips",
  "slug": "best-dog-training-tips",
  "status": "published",
  "publishedAt": "2024-03-15T10:00:00Z",
  "metaDescription": "Discover the 10 best ways to train your puppy...",
  "featuredImage": "https://cdn.sitelift.io/images/...",
  "html": "<p className="leading-loose">Training a dog is rewarding...</p>",
  "schema": {
    "@context": "https://schema.org",
    "@type": "Article",
    "headline": "10 Best Dog Training Tips"
  }
}

Get Sitemap Entries

Returns all published article slugs and updated timestamps, perfect for generating your site's sitemap.xml.

{
  "entries": [
    {
      "slug": "best-dog-training-tips",
      "updatedAt": "2024-03-15T10:00:00.000Z"
    }
  ]
}

Rate Limits

The Delivery API is limited to 100 requests per minute per API token. If you exceed this, you will receive a 429 Too Many Requests response with a Retry-After header; wait that long and retry. Limits are per token, not per IP, so builds on shared CI or serverless egress addresses are not throttled by other customers.

For high-traffic sites, we strongly recommend implementing caching on your end (e.g., Next.js ISR, Redis, or a CDN) rather than fetching from the SiteLift API on every user request.