Referência da API

Busque HTML de blog e metadados SEO na sua stack. Caminho base: `/api/v1`.

Conteúdo que já está no seu site

Webhooks só disparam quando o GrowthDailySeo cria um rascunho novo. Conteúdo que já está no CMS não é enviado automaticamente.

Importe uma vez paginando `GET /posts` com `status=published` (e `status=draft` para rascunhos).
Guarde `updatedAt` e use `updatedAfter` para atualizações sem baixar o catálogo inteiro.
Use `If-None-Match` com o `ETag` da resposta para ignorar páginas inalteradas.

GET/api/v1/sites/:siteId/posts

Artigos paginados para sync com CMS. Retorna rascunho e publicado por padrão (rascunhos da produção de conteúdo podem ser importados imediatamente).

Parâmetros de consulta

page — Número da página (padrão 1)
pageSize — Itens por página, máx. 50 (padrão 12)
search — Filtro de título sem distinção de maiúsculas
status — Filtro: `draft`, `published` ou `all` (padrão — rascunho + publicado, recomendado para sync do CMS)
language — Código ISO (ex.: `en`, `tr`) — corresponde a `language` de cada post
updatedAfter — Timestamp ISO 8601 — apenas posts atualizados depois desse momento

Resposta 200

{
  "items": [{
    "id": "...",
    "slug": "my-post",
    "title": "...",
    "contentHtml": "<article>...</article>",
    "status": "draft",
    "seo": {
      "metaDescription": "...",
      "ogTitle": "...",
      "ogDescription": "...",
      "keywords": ["..."]
    },
    "faqJsonLd": { "@type": "FAQPage", ... }
  }],
  "page": 1,
  "pageSize": 12,
  "total": 42,
  "totalPages": 4
}

GET/api/v1/sites/:siteId/posts/:slug

Payload completo do artigo: contentHtml, excerpt, seo, faqJsonLd. Funciona para slugs em rascunho e publicados.

GET/api/v1/sites/:siteId/guides/:slug

Retorna um único guia publicado por slug.

Resposta 200 (JSON camelCase)

{
  "id": "...",
  "slug": "my-guide",
  "title": "...",
  "contentHtml": "<article>...</article>",
  "status": "published",
  "publishedAt": "2026-07-21T12:00:00.000Z",
  "updatedAt": "2026-07-21T12:00:00.000Z"
}

GET/api/v1/sites/:siteId/sitemap.xml

Sitemap XML de posts e guias publicados. Auth com Bearer ou `?token=` para crawlers.

GET/api/v1/sites/:siteId/training/export

Transmite linhas de treinamento com opt-in como NDJSON (máx. 500). Content-Type: application/x-ndjson.

POST/api/v1/webhooks/test

Envia um payload de teste para sua URL de webhook configurada. Retorna 400 se nenhuma URL estiver definida.

Consulte códigos de erro