Conteúdo

O núcleo da API de entrega. Retorna os itens publicados da marca, cada um com o corpo em markdown/HTML e o JSON-LD já derivado do tipo.

Listar conteúdo

string

required

Sua chave de API de conteúdo (ou envie no header x-api-key).

string

Filtra por tipo (ex.: page, post, product, ou a chave de um tipo personalizado). Sem filtro, retorna todos os tipos.

number

default:"100"

Itens por página. Máximo 200 — valores acima são reduzidos ao máximo.

string

Token opaco da próxima página, obtido do header X-Next-Cursor da resposta anterior. Veja Paginação.

curl "https://api.citou.me/cd/content?type=post&key=SUA_CHAVE"

const res = await fetch("https://api.citou.me/cd/content?type=post", {
  headers: { "x-api-key": process.env.CITOU_KEY },
});
const posts = await res.json();

Retorna um array de itens (mais recentes primeiro):

Resposta

[
  {
    "type": "post",
    "slug": "como-aparecer-no-chatgpt",
    "title": "Como aparecer no ChatGPT",
    "metaDescription": "Guia prático de AEO.",
    "data": { "title": "Como aparecer no ChatGPT", "body": "…", "faq": [] },
    "bodyMarkdown": "Texto do post…\n\n## Perguntas frequentes\n…",
    "html": "<p>Texto do post…</p>",
    "jsonLd": "{\n  \"@context\": \"https://schema.org\",\n  \"@type\": \"Article\",\n  \"headline\": \"Como aparecer no ChatGPT\"\n}",
    "seo": { "canonicalUrl": "", "noindex": false, "ogImage": "" },
    "sourceUrl": null,
    "publishedAt": "2026-07-25T14:00:00.000Z",
    "updatedAt": "2026-07-25T14:00:00.000Z"
  }
]

Paginação

A lista é paginada por cursor. Cada resposta traz até limit itens (padrão 100, máximo 200), ordenados por publishedAt desc — com o id como desempate estável, então percorrer as páginas nunca duplica nem pula itens. Quando há mais itens, a resposta inclui o header X-Next-Cursor; repasse-o em ?cursor= para a próxima página. A ausência do header significa que você chegou à última página.

O corpo é sempre um array puro — a paginação vive no header X-Next-Cursor. Não há total; pare quando o header não vier.

Para consumir todo o conteúdo (ex.: gerar todas as páginas no build), percorra os cursores:

Buscar tudo

async function fetchAll(type) {
  const base = "https://api.citou.me/cd/content";
  const items = [];
  let cursor = null;
  do {
    const url = `${base}?type=${type}&limit=200${cursor ? `&cursor=${encodeURIComponent(cursor)}` : ""}`;
    const res = await fetch(url, { headers: { "x-api-key": process.env.CITOU_KEY } });
    items.push(...(await res.json()));
    cursor = res.headers.get("X-Next-Cursor");
  } while (cursor);
  return items;
}

Passar limit sem seguir o X-Next-Cursor retorna apenas a primeira página. Para catálogos grandes (ex.: product), percorra os cursores — senão você publica um conjunto truncado.

Obter por slug

GET /cd/content/{slug} — um único item publicado (o slug é único por marca).

curl "https://api.citou.me/cd/content/como-aparecer-no-chatgpt?key=SUA_CHAVE"

const res = await fetch(
  `https://api.citou.me/cd/content/${slug}?key=${process.env.CITOU_KEY}`,
);
if (res.status === 404) {
  /* não publicado */
}
const item = await res.json();

Campos da resposta

string

Chave do tipo de conteúdo.

string

Slug único do item na marca.

string

Título.

string

Meta descrição.

object

Valores tipados dos campos. Campos de referência já vêm resolvidos para o nome.

string

Corpo em markdown otimizado para IAs.

string

O mesmo corpo renderizado em HTML.

string

O schema.org JSON-LD do item, como string — insira num <script type="application/ld+json">. Vazio quando não há nada a emitir.

object

Controles por página: canonicalUrl, noindex (boolean), ogImage.

string | null

URL canônica de origem (quando o item foi reconciliado com uma página existente do site).

string

Data de publicação (ISO 8601).

string

Última atualização (ISO 8601).

Precisa apenas do markdown pronto para rastreadores de IA (com front-matter e JSON-LD embutido)? Use o endpoint de Markdown para IAs.

Começando

API de entrega (/cd)

Listar conteúdo

Paginação

Obter por slug

Campos da resposta

​Listar conteúdo

​Paginação

​Obter por slug

​Campos da resposta

Listar conteúdo

Paginação

Obter por slug

Campos da resposta