AI search discovery

Measure how AI search engines see your site, with one script tag and an audit.

AI search engines answer a question by reading pages and quoting them. Discovery shows whether those engines can read your site, which of their crawlers visit it, and what to change so that your pages can be quoted. The routes are in the Analytics and discovery reference.

Add the tag

One script in the head of each page reports what the page offers a crawler: whether structured data is present, whether the content is in the HTML the server sends, and the page metadata. It sets no cookie. It works in any framework and in site builders that let you add code to the head.

HTML:

<script async src="https://api.rivier.ai/geo/tag.js" data-site="example.com"></script>

Audit a page

POST /geo/audit scores a page on the four things that decide whether an engine can read and quote it. Needs the scope analytics:write.

Request:

curl -sS https://api.rivier.ai/geo/audit \
  -H "Authorization: Bearer $RIVIER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://example.com/" }'

• Valid schema.org JSON-LD, such as Organization, Product or FAQPage, so that names and facts are stated and not guessed from prose.
• The content is in the HTML the server sends, so crawlers that do not run scripts can read it.
• robots.txt lets the crawlers in that you want to be quoted by. A blocked crawler cannot quote you.
• Pages lead with the answer, name things clearly and show when they were last updated.

What else you can read

GET /geo/telemetry lists AI crawler visits to a site. GET /geo/tracker shows the prompts you track and where you stand in the answers. GET /geo/recommendations lists what to change to be quoted more. POST /geo/simulate shows how an answer engine would see a page.