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
$ 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/v1Authorization-header
Authorization: Bearer sca_live_your_token_here# 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())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
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.
Maak een sleutel aan
Open API-tokens in je dashboard en genereer een Bearer-token. Kopieer het eenmalig — het begint met `sca_live_`.
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.
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 MCPTerminal & CLI
Voor scripts en CI/CD — stuur je data aan vanuit elke MCP-geschikte terminal-agent.
Bekijk de CLIWie 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.