REST-API · v1 · Live docs

SEO-API til din egen stak

Dine SEO- og AI-synlighedsdata, via ét rent REST-endpoint.

Hent data fra Google Search Console, placeringer og AI Tracker direkte ind i dit produkt, dit dashboard eller dit data warehouse. Autentificér med en Bearer-nøgle fra dit dashboard, kald REST /v1, og få typet JSON retur — det samme kanoniske datalag, der driver MCP'en fra SEOcrawl AI. GA4, fuld eksport fra site audit og multi-tenant partner-OAuth er de næste skridt.

Claude
Codex CLI
Cursor
SEOcrawl AI REST API — curl request and typed JSON response
SEOcrawl AI REST API examples in cURL, JavaScript and Python

Autentificér én gang. Kald REST.

Lav et Bearer-token i dit dashboard, og send det med i Authorization-headeren. Samme nøgle virker på både REST-API'et og MCP-serveren.

Base-URL

https://api.seocrawl.ai/v1

Authorization-header

Authorization: Bearer sca_live_your_token_here

Ét datalag, to flader

Hvert REST-endpoint læser fra det samme kanoniske lag som MCP-værktøjerne — så dit dashboard og dine AI-agenter altid ser de samme tal. Disse grupper er live i v1; mere dækning kommer til løbende.

Properties

Vis de Search Console-properties, du har adgang til. Brug hver propertys id i stien på alle data-endpoints.

  • GET/v1/propertiesLive

Google Search Console

Klik, visninger, CTR og gennemsnitlig position — pr. søgning, side, datointerval og periode mod periode. Alle detaljer på den separate side om 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

Læs de prompts, du holder øje med for brandomtaler i ChatGPT, Claude, Gemini og Perplexity.

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

Opgaver

Læs og skriv SEO-opgaver — kobl dit opgavebræt sammen med din egen projektstyring.

  • 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 og indeksering

Trafik, AI-henvisninger og indekseringsstatus. Forbindelsen står klar; REST-endpointsene er på vej.

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

Site Audit

Crawl-status, on-page, teknisk og lister over fejl — hele datasættet fra auditten, tilgængeligt via REST.

  • GET/v1/properties/{id}/audit/summarySnart
  • GET/v1/properties/{id}/audit/issuesSnart

Bygget til produkter, ikke til scrapere

Et rigtigt REST-API med Bearer-auth, scopes og rate limits — som deler ét kanonisk datalag med MCP'en, så tallene aldrig driver fra hinanden.

Ren REST, typet JSON

Forudsigelige ressourcer, standardverber, typede JSON-svar og fejl efter RFC (401 ikke autentificeret, 403 scope_required, 429 med Retry-After). Ingen HTML-scraping, ingen skrøbelige eksporter.

Ét kanonisk datalag

REST-endpoints og MCP-værktøjer er søskende oven på de samme providere, og pariteten testes i CI. Dit dashboard og dine AI-agenter ser altid de samme klik, visninger og positioner.

Nøgler du selv laver

Lav og tilbagekald Bearer-tokens på sekunder i dit dashboard. Den samme sca_live_-nøgle autentificerer både REST-API'et og MCP-serveren — ét credential, to flader.

Dokumenterede rate limits

60 requests i minuttet og 1.000 i timen pr. token, med tydelige 429-svar og Retry-After. REST-grænserne er en pulje for sig, adskilt fra forbruget på MCP'en — den ene dræner aldrig den anden.

Adgang styret af scopes

Grovkornede læse- og skrive-scopes beskytter hvert endpoint og håndhæves i firewallen med standardsvar om step-up. Giv en nøgle præcis det, den skal bruge — ikke mere.

Multi-tenant, på vej

Et Google OAuth-flow pr. tenant, så partnere kan forbinde alle deres kunders GSC-properties under én konto — med streng adskillelse af data. Under aktiv udvikling; spørg os om tidlig adgang.

Kom i gang på 3 trin

Fra nul til dit første autentificerede kald på få minutter.

1

Lav en nøgle

Åbn API-tokens i dit dashboard, og generér et Bearer-token. Kopiér det med det samme — det begynder med sca_live_.

2

Send headeren

Send Authorization: Bearer sca_live_… med på hvert request til https://api.seocrawl.ai/v1. Den samme nøgle virker også med MCP-serveren.

3

Hent data

Kald GET /v1/properties for at få et property-id, og gå derefter til /v1/properties/{id}/… for performance i GSC, prompts i AI Tracker eller opgaver — og send JSON'en direkte videre til dit produkt, dit dashboard eller dit warehouse.

Tre veje til dine data

Samme tal, forskellige flader — vælg den, der passer til måden, du bygger på.

REST-API

Til produkter, dashboards og datapipelines. Bearer-auth, typet JSON, rate limits. Du står på siden lige nu.

MCP-server

Til AI-agenter — Claude, ChatGPT og enhver MCP-klient spørger til dine data i naturligt sprog.

Udforsk MCP'en

Terminal og CLI

Til scripts og CI/CD — styr dine data fra enhver MCP-klar terminalagent.

Se CLI'en

Hvem bygger på API'et

Teams, der vil have SEO- og AI-synlighedsdata ind i deres egne systemer.

SaaS og partnere

Læg live SEO-tal ind i jeres eget produkt. Giv brugerne data fra Search Console og AI-synlighed uden selv at bygge pipelines.

Bureauer

Send hver kundes data over i jeres egen portal, i Looker Studio eller ind i jeres rapporteringslag — én nøgle, alle properties, ingen manuel eksport.

Datateams

Læg GSC-, placerings- og AI Tracker-data i jeres warehouse efter en fast plan. Kobl dem til omsætning, og byg de modeller, jeres dashboards har brug for.

Udviklere

Automatisér tjek og alarmer, hold opgaver i sync med jeres projektværktøj, og byg overvågning af AI-synlighed ind i de apps, I allerede leverer.

Ofte stillede spørgsmål

Findes der virkelig et offentligt SEO-API?

Ja — et Bearer-autentificeret REST-/v1-API er live og dækker performance i Search Console, properties, prompts i AI Tracker og opgaver, med hele den offentlige reference på api.seocrawl.ai/docs. Bredere dækning (GA4, fuld eksport fra site audit) og multi-tenant partner-OAuth er de næste skridt. Mangler du noget, der ikke er live endnu? Spørg os om tidlig adgang.

Hvordan autentificerer jeg?

Med et Bearer-token. Lav en sca_live_-nøgle i dit dashboard, og send den som Authorization: Bearer <key> på hvert request. Til din egen konto er der ingen OAuth-dans — kun headeren.

Er det den samme nøgle som til MCP'en?

Ja. Det samme token autentificerer både REST-API'et og MCP-serveren, fordi begge læser fra ét kanonisk datalag. Ét credential, to flader — og de samme tal begge steder.

Hvad er grænserne for antal requests?

60 requests i minuttet og 1.000 i timen pr. token. Går du over, får du en 429 med en Retry-After-header. REST-grænserne tælles adskilt fra forbruget på MCP'en, så de to aldrig konkurrerer om det samme budget.

Kan jeg forbinde mine kunders Search Console-properties?

Det multi-tenant partnerflow — et Google OAuth pr. tenant, så du kan forbinde alle dine kunders GSC-properties under din egen konto med streng adskillelse af data — er under aktiv udvikling. Bygger du en partnerintegration? Så tag fat i os for tidlig adgang.

Hvilke data kan jeg hente i dag?

Overblik og periodesammenligninger fra Search Console, topsøgeord og topsider, detaljer for ét søgeord eller én side, listen over dine properties, prompts i AI Tracker og fuld læse- og skriveadgang til opgaver. Det spejler det, MCP'en giver adgang til — bare via REST.

Klar til at bygge på dine SEO-data?

Lav en Bearer-nøgle i dit dashboard, og lav dit første REST-kald på få minutter — eller tal med os om adgang for partnere og multi-tenant.