Developer docs
Your articles, in your own stack.
CitedSEO writes and updates your articles. A static feed and a signed webhook put them on a site you build yourself, drawn with your own components.
No key and nothing to install. Your site ID is all the feed needs.
GET
https://feeds.citedseo.ai/{siteId}/b/{buildId}/page-1.json{ "articles": [ { "id": "0b6f6c1e-3f0a-4a59-9d0e-2f8f4c1f7a31", "slug": "how-to-brew-green-tea", "url": "https://example.com/blog/how-to-brew-green-tea", "title": "How to brew green tea", "description": "Brew green tea at 80°C for two minutes. Here is why the temp…", "cover": { "src": "https://example.com/images/green-tea.webp", "alt": "A glass teapot of green tea" }, "author": { "name": "Sam Lee", "url": "https://example.com/authors/sam-lee" }, "publishedAt": "2026-10-09T02:05:00.000Z", "modifiedAt": "2026-10-11T02:05:00.000Z", "html": "<p class=\"citedseo-answer\"><strong>Brew green tea at 80°C for two minutes. Hot…", "markdown": "**Brew green tea at 80°C for two minutes. Hotter water makes…", "structuredData": { "@context": "https://schema.org", "@graph": [ "…" ] } } ]}POST
https://your-site.com/webhooks/citedseocitedseo-signature: t=…,v1=…{ "event": "article.published", "delivery": "5d1c3b0a-8e42-4f6b-9a57-0c2f1e9b7d44:b7a1f3c2-6d58-4e0a-8c39-41f2a9d05e16", "data": { "id": "0b6f6c1e-3f0a-4a59-9d0e-2f8f4c1f7a31", "slug": "how-to-brew-green-tea", "url": "https://example.com/blog/how-to-brew-green-tea", "title": "How to brew green tea", "description": "Brew green tea at 80°C for two minutes. Here is why the temp…", "cover": { "src": "https://example.com/images/green-tea.webp", "alt": "A glass teapot of green tea" }, "author": { "name": "Sam Lee", "url": "https://example.com/authors/sam-lee" }, "publishedAt": "2026-10-09T02:05:00.000Z", "modifiedAt": "2026-10-11T02:05:00.000Z", "html": "<p class=\"citedseo-answer\"><strong>Brew green tea at 80°C for two minutes. Hot…", "markdown": "**Brew green tea at 80°C for two minutes. Hotter water makes…", "structuredData": { "@context": "https://schema.org", "@graph": [ "…" ] } }}- No API key
- Your site ID is the read key. The feed is static files holding only what is already public on your site.
- The whole article
- Title, search snippet, cover, byline and dates, with the body as both HTML and Markdown.
- Structured data included
- Each article comes with its schema.org JSON-LD, worked out from the version that is live.
- Signed webhooks
- A post when an article goes live or changes, signed with HMAC-SHA256 so your code can tell it is ours.
Pick your framework
A blog in the stack you already have
Each guide adds a blog index and an article page with metadata and structured data, with a typed package for each.
- Start hereQuickstartFetch your articles and show one, in about five minutes.
- The feedRead the feedA manifest, pages of articles and one file per article, each field explained.
- WebhooksHow webhooks workAdd an endpoint, verify the signature and handle retries.
- GuidesHow publishing worksWhat "published" means, and what your code sees when it happens.