Riferimento API

Recupera HTML blog e metadati SEO nel tuo stack. Percorso base: `/api/v1`.

Contenuti già presenti sul tuo sito

I webhook partono solo quando GrowthDailySeo crea una nuova bozza. I contenuti già nel CMS non vengono inviati automaticamente.

Importa una volta paginando `GET /posts` con `status=published` (e `status=draft` per le bozze).
Salva `updatedAt` e usa `updatedAfter` per gli aggiornamenti senza scaricare tutto il catalogo.
Usa `If-None-Match` con l'`ETag` della risposta per saltare le pagine invariate.

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

Articoli paginati per sync CMS. Restituisce bozza e pubblicato per impostazione predefinita (le nuove bozze sono importabili subito).

Parametri di query

page — Numero pagina (predefinito 1)
pageSize — Elementi per pagina, max 50 (predefinito 12)
search — Filtro titolo senza distinzione maiuscole/minuscole
status — Filtro: `draft`, `published` o `all` (predefinito — bozza + pubblicato, consigliato per il sync CMS)
language — Codice lingua ISO (es. `en`, `tr`) — corrisponde a `language` di ogni articolo
updatedAfter — Timestamp ISO 8601 — solo articoli aggiornati dopo quel momento

Risposta 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 articolo: contentHtml, excerpt, seo, faqJsonLd. Funziona per slug in bozza e pubblicati.

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

Restituisce una singola guida pubblicata per slug.

Risposta 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 di articoli e guide pubblicati. Auth con Bearer o `?token=` per i crawler.

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

Trasmette righe training opt-in come NDJSON (max 500). Content-Type: application/x-ndjson.

POST/api/v1/webhooks/test

Invia un payload di test all'URL webhook configurato. Restituisce 400 se nessun URL è impostato.

Vedi codici errore