Referentie van de content-API │ Rankfender Docs

De content-API is alleen-lezen. Ze geeft de gepubliceerde artikelen van het project waarbij je API-sleutel hoort terug als JSON, zodat je site ze op eigen pagina's kan tonen.

Endpoint

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

Eén adres voor beide aanroepen. Stuur je sleutel mee in de header X-Rankfender-Key (zie Je API-sleutel). Alleen artikelen met de status „gepubliceerd” komen terug.

Je artikelen opvragen

Zonder id geeft de API een pagina artikelen terug, de nieuwste eerst.

Parameter	Standaard	Wat hij doet
limit	10	Hoeveel artikelen je terugkrijgt, van 1 tot 100.
offset	0	Hoeveel artikelen worden overgeslagen. Gebruik hem met has_more om te bladeren.

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 }
}

De lijst geeft per artikel id, titel, beschrijving, taal en datums, zonder de inhoud. Neem hier de id om één artikel op te halen.

Eén artikel ophalen

Met id geeft de API dat artikel terug met de volledige inhoud als 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"
  }
}

Velden

Veld	Betekenis
id	De identificatie van het artikel.
title	De titel van het artikel.
content	De tekst van het artikel als HTML (alleen bij één artikel).
description	De metabeschrijving.
language	De taalcode van het project, bijvoorbeeld en of nl.
published_at	De publicatiedatum, of de aanmaakdatum als die ontbreekt.
updated_at	De laatste wijziging.
pagination.total / has_more	Hoeveel gepubliceerde artikelen er zijn en of er nog een pagina volgt.

Fouten

Status	Melding	Wat te doen
401	"API key required. Pass via X-Rankfender-Key header."	Voeg de header toe.
401	"Invalid API key"	Controleer de sleutel; maak een nieuwe als hij is vervangen.
404	"Article not found or not published"	De id klopt niet, hoort bij een ander project of het artikel is niet gepubliceerd.
500	"Internal server error"	Probeer het opnieuw; neem contact op met support als het blijft gebeuren.

Voorbeeld in JavaScript

Roep de API aan vanuit servercode, zodat de sleutel nooit in de browser van bezoekers komt.

// 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();

Let op

Kopieer het voorbeeld „Direct API” van de kaart. De voorbeelden voor Next.js, React, Vue en iframe laden een script dat niet beschikbaar is: gebruik gewone HTTP-aanroepen zoals op deze pagina.