API reference

Example article and schema

One of every block type in the exact shape of a single read, and the block JSON Schema. No key needed.

Build and test a renderer before you have an account, or check one in CI:

text

GET https://api.seoforsaas.dev/public/v1/fixtures/article      # the articleGET https://api.seoforsaas.dev/public/v1/schema/blocks.json    # JSON Schema of the blocks

The article is what a content key's read returns, related included: every block type, both list kinds, all three callout variants, a cited link with its rel, and SEO metadata built by the same code that builds real articles. When we add a block type, it appears here first.

Example article · every block type

How Google decides what to show for a search

Quick answer: Google finds pages by crawling, stores what it understands in an index, and ranks the indexed pages for each query by how well they answer it. Most of what you can influence happens in the last step.

Crawling, indexing, ranking

Google describes the process in three stages in its own guide to how Search works. A page that is never crawled cannot be indexed, and a page that is not indexed cannot rank.

Crawling: discovering URLs and downloading pages.
Indexing: reading a page and storing what it is about.
Serving: choosing and ordering results for one query.

A team building a rocket together, a metaphor for launching a page — Every page starts at step one: being found.

What a crawler needs

A link to the page from somewhere it already knows.
A sitemap.xml listing the URL.
A server that answers with 200.

Signals that decide the order

Signal	What it measures	What you control
Relevance	Does the page answer this query?	Topic and structure
Quality	Is it trustworthy and original?	Sources and depth
Usability	Does it load and read well?	Your templates

Our goal is to organize the world’s information and make it universally accessible and useful.

Google’s mission statement

<meta name="robots" content="noindex">

FAQ

How long does it take for a new page to appear in Google?

Anywhere from a few days to a few weeks. On our own sites the median is three days to the first impression.

Does submitting a sitemap guarantee indexing?

No. It helps Google find the URL; whether it is indexed depends on the page.