REST-API · v1 · Live docs

SEO-API voor je eigen stack

Je SEO- en AI-zichtbaarheidsdata, via een schoon REST-endpoint.

Haal Google Search Console-, ranking- en AI Tracker-data rechtstreeks in je product, dashboard of data warehouse. Authenticeer met een Bearer-sleutel uit je dashboard, roep REST `/v1` aan en krijg getypte JSON terug — dezelfde canonieke datalaag die de MCP van SEOcrawl AI aandrijft. GA4, volledige site-audit-export en multi-tenant partner-OAuth komen als volgende.

Bearer-auth · 60 req/min · Dezelfde datalaag als de MCP · Geen scraping

seocrawl — REST /v1

$ curl "https://api.seocrawl.ai/v1/properties/$ID/gsc/summary?range=last_28_days" \

-H "Authorization: Bearer sca_live_…"

{ "data": {

"period": { "from": "2026-06-09", "to": "2026-07-06" },

"metrics": {

"clicks": 2388, "impressions": 811019,

"ctr": 0.00294, "position": 22.87

},

"metrics_diff": { "clicks": 584, … }

} }

Eén keer authenticeren. REST aanroepen.

Maak een Bearer-token aan vanuit je dashboard en geef het mee in de Authorization-header. Dezelfde sleutel werkt zowel op de REST-API als op de MCP-server.

Basis-URL

https://api.seocrawl.ai/v1

Authorization-header

Authorization: Bearer sca_live_your_token_here
cURLJavaScriptPython
# cURL — resolve a property id, then query it
curl https://api.seocrawl.ai/v1/properties \
  -H "Authorization: Bearer sca_live_…"

curl "https://api.seocrawl.ai/v1/properties/$ID/gsc/summary?range=last_28_days" \
  -H "Authorization: Bearer sca_live_…"

// JavaScript
const res = await fetch(
  "https://api.seocrawl.ai/v1/properties/" + id + "/gsc/summary?range=last_28_days",
  { headers: { Authorization: "Bearer sca_live_…" } }
);
const data = await res.json();

# Python
import requests
r = requests.get(
  f"https://api.seocrawl.ai/v1/properties/{id}/gsc/summary",
  params={"range": "last_28_days"},
  headers={"Authorization": "Bearer sca_live_…"},
)
print(r.json())
Endpoints

Eén datalaag, twee oppervlakken

Elk REST-endpoint leest uit dezelfde canonieke laag als de MCP-tools — zodat je dashboard en je AI-agents altijd identieke cijfers zien. Deze groepen zijn live in v1; meer dekking komt er doorlopend bij.

Properties

Toon de Search Console-properties waartoe je toegang hebt. Gebruik de `id` van elke property in het pad van elk data-endpoint.

  • GET/v1/propertiesLive

Google Search Console

Klikken, vertoningen, CTR en gemiddelde positie — per zoekopdracht, pagina, datumbereik en periode-op-periode.

  • GET/v1/properties/{id}/gsc/summaryLive
  • GET/v1/properties/{id}/gsc/compareLive
  • GET/v1/properties/{id}/gsc/top-keywordsLive
  • GET/v1/properties/{id}/gsc/top-pagesLive
  • GET/v1/properties/{id}/gsc/keywords/detailLive
  • GET/v1/properties/{id}/gsc/pages/detailLive

AI Tracker

Lees de prompts die je monitort op merkvermeldingen in ChatGPT, Claude, Gemini en Perplexity.

  • GET/v1/properties/{id}/ai-tracker/promptsLive

Taken

Lees en schrijf SEO-taken — koppel je takenbord aan je eigen projectmanagement-stack.

  • GET/v1/properties/{id}/tasksLive
  • POST/v1/properties/{id}/tasksLive
  • GET/v1/properties/{id}/tasks/{ticketId}Live
  • PATCH/v1/properties/{id}/tasks/{ticketId}Live
  • POST/v1/properties/{id}/tasks/{ticketId}/commentsLive

GA4 & Indexatie

Verkeer, AI-referrers en indexatiestatus. De koppeling staat klaar; de REST-endpoints komen eraan.

  • GET/v1/properties/{id}/ga4/summaryBinnenkort
  • GET/v1/properties/{id}/indexation/summaryBinnenkort

Site Audit

Crawl-gezondheid, on-page, technisch en probleemlijsten — de volledige auditdataset, ontsloten via REST.

  • GET/v1/properties/{id}/audit/summaryBinnenkort
  • GET/v1/properties/{id}/audit/issuesBinnenkort
Waarom deze API

Gebouwd voor producten, niet voor scrapers

Een echte REST-API met Bearer-auth, scopes en rate limits — die één canonieke datalaag deelt met de MCP, zodat de cijfers nooit uiteenlopen.

Schone REST, getypte JSON

Voorspelbare resources, standaardwerkwoorden, getypte JSON-responses en RFC-conforme fouten (401 niet-geauthenticeerd, 403 scope_required, 429 met Retry-After). Geen HTML-scraping, geen brooze exports.

Eén canonieke datalaag

REST-endpoints en MCP-tools zijn broers en zussen over dezelfde providers, met pariteit getest in CI. Je dashboard en je AI-agents zien altijd identieke klikken, vertoningen en posities.

Self-service-sleutels

Maak Bearer-tokens aan en trek ze in binnen seconden vanuit je dashboard. Dezelfde sca_live_-sleutel authenticeert zowel de REST-API als de MCP-server — één credential, twee oppervlakken.

Gedocumenteerde rate limits

60 verzoeken per minuut en 1.000 per uur per token, met duidelijke 429- + Retry-After-responses. REST-limieten vormen een aparte pool los van MCP-gebruik — de een put de ander nooit uit.

Toegang op basis van scopes

Grove lees- en schrijfscopes beschermen elk endpoint, afgedwongen op de firewall met standaard step-up-responses. Geef een sleutel alleen wat die nodig heeft.

Multi-tenant, komt eraan

Een Google OAuth-flow per tenant zodat partners elk van de GSC-properties van hun klanten onder één account kunnen koppelen — met strikte data-isolatie. In actieve ontwikkeling; vraag ons om vroege toegang.

Begin in 3 stappen

Van nul naar je eerste geauthenticeerde aanroep in een paar minuten.

1

Maak een sleutel aan

Open API-tokens in je dashboard en genereer een Bearer-token. Kopieer het eenmalig — het begint met `sca_live_`.

2

Stuur de header

Geef `Authorization: Bearer sca_live_…` mee bij elk verzoek aan `https://api.seocrawl.ai/v1`. Dezelfde sleutel werkt ook met de MCP-server.

3

Haal data op

Roep `GET /v1/properties` aan om een property-`id` te krijgen en benader daarna `/v1/properties/{id}/…` voor GSC-prestaties, AI Tracker-prompts of taken — en pijp de JSON rechtstreeks je product, dashboard of warehouse in.

Drie manieren om bij je data te komen

Dezelfde cijfers, ander oppervlak — kies degene die past bij hoe jij bouwt.

REST-API

Voor producten, dashboards en datapijplijnen. Bearer-auth, getypte JSON, rate limits. Je bent nu op deze pagina.

MCP-server

Voor AI-agents — Claude, ChatGPT en elke MCP-client bevragen je data in natuurlijke taal.

Verken de MCP

Terminal & CLI

Voor scripts en CI/CD — stuur je data aan vanuit elke MCP-geschikte terminal-agent.

Bekijk de CLI

Wie bouwt er op de API

Teams die SEO- en AI-zichtbaarheidsdata in hun eigen systemen willen.

SaaS & partners

Sluit live SEO-metrics in de UI van je eigen product in. Geef je gebruikers Search Console- en AI-zichtbaarheidsdata zonder zelf de pijplijnen te bouwen.

Bureaus

Pijp de data van elke klant naar een eigen portaal, Looker Studio of je rapportagelaag — één sleutel, elke property, geen handmatige exports.

Datateams

Land GSC-, ranking- en AI Tracker-data volgens schema in je warehouse. Koppel het aan omzet en bouw de modellen die je dashboards nodig hebben.

Ontwikkelaars

Automatiseer controles en meldingen, synchroniseer taken met je PM-tool en bouw AI-zichtbaarheidsmonitoring in de apps die je al uitlevert.

Veelgestelde vragen

Is er echt een publieke SEO-API?

Ja — een Bearer-geauthenticeerde REST-`/v1`-API is live en dekt Search Console-prestaties, properties, AI Tracker-prompts en taken, met de volledige publieke referentie gepubliceerd op api.seocrawl.ai/docs. Bredere dekking (GA4, volledige site-audit-export) en multi-tenant partner-OAuth komen als volgende. Iets nodig dat nog niet live is? Vraag ons om vroege toegang.

Hoe authenticeer ik?

Met een Bearer-token. Maak een `sca_live_`-sleutel aan vanuit je dashboard en stuur die als `Authorization: Bearer <key>` bij elk verzoek. Voor je eigen account is er geen OAuth-dans — alleen de header.

Is het dezelfde sleutel als de MCP?

Ja. Hetzelfde token authenticeert zowel de REST-API als de MCP-server, omdat beide uit één canonieke datalaag lezen. Eén credential, twee oppervlakken — en identieke cijfers over beide.

Wat zijn de rate limits?

60 verzoeken per minuut en 1.000 per uur per token. Overschrijd je ze, dan krijg je een `429` met een `Retry-After`-header. REST-limieten worden apart bijgehouden van MCP-gebruik, zodat de twee nooit om hetzelfde budget strijden.

Kan ik de Search Console-properties van mijn klanten koppelen?

Die multi-tenant partner-flow — een Google OAuth per tenant zodat je elk van de GSC-properties van je klanten onder je eigen account kunt koppelen, met strikte data-isolatie — is in actieve ontwikkeling. Bouw je een partnerintegratie? Neem contact op voor vroege toegang.

Welke data kan ik vandaag ophalen?

Search Console-samenvatting en periodevergelijkingen, topkeywords en -pagina's, detail van één keyword/pagina, je lijst met properties, AI Tracker-prompts en volledige lees-/schrijftoegang op taken. Het weerspiegelt wat de MCP blootstelt, via REST.

Klaar om op je SEO-data te bouwen?

Maak een Bearer-sleutel aan vanuit je dashboard en doe binnen enkele minuten je eerste REST-aanroep — of praat met ons over partner- en multi-tenant-toegang.