Skip to content
Docs

Introduction

CitedSEO writes and updates your site’s articles. These docs are for the developer who wants those articles on a site they build themselves: a Next.js app, an Astro site, anything that can make an HTTP request.

There are two things to use, and neither needs an API key.

The feed

Section titled “The feed”

Every article that is live on your site, as static JSON on feeds.citedseo.ai:

feeds.citedseo.ai/{siteId}/feed/index.json                    the manifest
feeds.citedseo.ai/{siteId}/b/{buildId}/page-1.json            20 articles a page
feeds.citedseo.ai/{siteId}/b/{buildId}/by-slug/{slug}.json    one article

They are plain files on Cloudflare’s network, rebuilt each time something publishes, so your site can read them as often as it likes. Each article comes whole: its title, search snippet, cover, byline, dates, the body as both HTML and Markdown, and its schema.org structured data. You fetch it and draw it with your own components.

Webhooks

Section titled “Webhooks”

When an article goes live or changes, CitedSEO can post it to an endpoint of yours, signed so your code can tell the post came from us. Use it to rebuild a static site or clear a cache the moment something publishes, instead of waiting for the next fetch.

Packages

Section titled “Packages”

For JavaScript and TypeScript there is a package for each: @citedseo/feed reads the feed and checks webhooks anywhere, and @citedseo/next, @citedseo/astro, @citedseo/react-router, @citedseo/nuxt and @citedseo/svelte fit it to a framework. They are typed end to end. In any other language, the feed is plain JSON over HTTP.

What is not here

Section titled “What is not here”
  • No write API. Articles are approved, changed and published in the CitedSEO app. The feed is read-only, and there is no API of ours for your site to call.
  • No API keys. Your site ID is the only thing the feed needs, and the feed holds only what is already public on your site.

Where to go next

Section titled “Where to go next”
QuickstartFetch your articles and show one, in about five minutes.
The articleEvery field the feed and the webhooks give you.
Verify the signatureCheck that a webhook came from CitedSEO.
Set up with AIHand these docs to your coding agent.