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.

Vraag je API-sleutel aanLees de API-docsVerken de MCP
Claude
Codex CLI
Cursor
SEOcrawl AI REST API — curl request and typed JSON response
SEOcrawl AI REST API examples in cURL, JavaScript and Python

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
Vraag je API-sleutel aanRead the API docs

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. Alle details op de aparte pagina over de Google Search Console API.

  • 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.

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
Vergelijk alle integraties

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.

Vraag je API-sleutel aanLees de API-docsBoek een demo