Content API reference

The content API is read-only. It returns the published articles of the project that owns your API key, as JSON, so your site can show them on its own pages.

Endpoint

GET https://odbowhcyfpzsifyibsdu.supabase.co/functions/v1/public-article-api

One address for both calls. Send your key in the X-Rankfender-Key header (see Your API key). Only articles with the status "published" are returned.

List your articles

Without an id, the API returns a page of articles, newest first.

curl "https://odbowhcyfpzsifyibsdu.supabase.co/functions/v1/public-article-api?limit=10&offset=0" \
  -H "X-Rankfender-Key: rfk_your_key"

{
  "success": true,
  "articles": [
    {
      "id": "8c1f…",
      "title": "…",
      "description": "…",
      "language": "en",
      "published_at": "2026-10-14T09:12:00Z",
      "updated_at": "2026-10-14T09:30:00Z"
    }
  ],
  "pagination": { "limit": 10, "offset": 0, "count": 1, "total": 1, "has_more": false }
}

The list gives each article's id, title, description, language and dates, without the content. Take the id from here to fetch one article.

Get one article

With id, the API returns that article with its full content as HTML.

curl "https://odbowhcyfpzsifyibsdu.supabase.co/functions/v1/public-article-api?id=ARTICLE_ID" \
  -H "X-Rankfender-Key: rfk_your_key"

{
  "success": true,
  "article": {
    "id": "8c1f…",
    "title": "…",
    "content": "<h2>…</h2><p>…</p>",
    "description": "…",
    "language": "en",
    "published_at": "2026-10-14T09:12:00Z",
    "updated_at": "2026-10-14T09:30:00Z"
  }
}

Fields

Errors

Example in JavaScript

Call the API from server-side code so the key never reaches visitors' browsers.

// Server-side code (Node 18+, Next.js server component, etc.)
const res = await fetch(
  "https://odbowhcyfpzsifyibsdu.supabase.co/functions/v1/public-article-api?limit=10",
  { headers: { "X-Rankfender-Key": process.env.RANKFENDER_KEY } }
);
const { articles, pagination } = await res.json();