Nyrav API

Read your AI-visibility, rankings, content and backlink data from your own dashboards (Looker Studio, Power BI, Tableau) or scripts. The API is read-only and part of Nyrav Enterprise.

Authentication

A workspace owner creates a key in Settings → Enterprise → API keys. Send it on every request:

curl https://nyrav.ai/api/v1/sites \
  -H "Authorization: Bearer nyk_your_key"

Keys read every site in their workspace. Revoke a key at any time in Settings.
Limit: 120 requests per minute per key. Data updates weekly (AI visibility, rankings) or when changes are published.
Errors return JSON like { "error": "…" } with status 401 (bad key), 403 (not on Enterprise), 404 (unknown site) or 429 (too many requests).

Endpoints

GET /api/v1/sites

Every website in the workspace with its latest SEO score and AI-visibility percentage.

{ "data": [ { "id": "4c1f…", "url": "https://example.com", "name": "Example", "seo_score": 86, "ai_visibility_percent": 23.5, "ai_checked_at": "2026-11-02T09:14:00Z" } ] }

GET /api/v1/sites/{id}/ai-visibility?runs=12

The latest weekly AI check, answer by answer (question, assistant, named or not, position, competitors named, sources cited), plus the score history for the last N checks.

{ "data": { "history": [ { "visibility_percent": 23.5, "checked_at": "…" } ], "latest": { "answers": [ { "question": "Best PPC agency for e-bike stores?", "engine": "chatgpt", "mentioned": false, "competitors_named": ["webfx.com"] } ] } } }

GET /api/v1/sites/{id}/rankings

Tracked keywords with their latest Google position and ranking URL.

{ "data": [ { "keyword": "google ads agency", "position": 7, "ranking_url": "https://example.com/google-ads/", "checked_at": "…" } ] }

GET /api/v1/sites/{id}/content

Articles and page changes Nyrav made: status, live URL, pages changed.

{ "data": [ { "type": "article", "title": "…", "status": "published", "url": "https://example.com/…", "keyword": "…", "words": 1316 } ] }

GET /api/v1/sites/{id}/backlinks

Sites pitched through outreach, and whether they now link to you.

{ "data": [ { "site": "Example Blog", "email_status": "sent", "link": "found", "linking_page": "https://…" } ] }

No code?

Download CSV files of the same data from Settings → Enterprise → Exports, or get alerts in Slack or Microsoft Teams when your AI visibility changes, a change is published or a backlink is won.