Amb un token Bearer. Genera una clau `sca_live_` des del teu tauler i envia-la com a `Authorization: Bearer ` a cada sol·licitud. No hi ha cap ball d'OAuth per al teu propi compte — només la capçalera.

API REST · v1 · Docs en directe

API SEO per al teu propi stack

Les teves dades de SEO i de visibilitat a la IA, a través d'un endpoint REST net.

Obtén dades de Google Search Console, de rànquing i d'AI Tracker directament al teu producte, tauler o magatzem de dades. Autentica't amb una clau Bearer del teu tauler, crida REST `/v1` i rep JSON tipat — la mateixa capa de dades canònica que impulsa l'MCP de SEOcrawl AI. GA4, l'exportació completa d'auditoria del lloc i l'OAuth multitenant per a partners arriben aviat.

Aconsegueix la teva clau d'API Explora l'MCP

Autenticació Bearer · 60 sol·licituds/min · La mateixa capa de dades que l'MCP · Sense 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, … }

} }

Autentica't una vegada. Crida REST.

Genera un token Bearer des del teu tauler i passa'l a la capçalera Authorization. La mateixa clau funciona tant a l'API REST com al servidor MCP.

URL base

https://api.seocrawl.ai/v1

Capçalera Authorization

Authorization: Bearer sca_live_your_token_here

Aconsegueix la teva clau d'API Read the API docs

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

Una capa de dades, dues superfícies

Cada endpoint REST llegeix de la mateixa capa canònica que les eines de l'MCP — de manera que el teu tauler i els teus agents d'IA sempre veuen xifres idèntiques. Aquests grups estan en directe a la v1; s'hi afegeix cobertura contínuament.

Propietats

Llista les propietats de Search Console a les quals pots accedir. Fes servir l'`id` de cada propietat al camí de cada endpoint de dades.

GET/v1/propertiesEn directe

Google Search Console

Clics, impressions, CTR i posició mitjana — per consulta, pàgina, interval de dates i període sobre període.

GET/v1/properties/{id}/gsc/summaryEn directe
GET/v1/properties/{id}/gsc/compareEn directe
GET/v1/properties/{id}/gsc/top-keywordsEn directe
GET/v1/properties/{id}/gsc/top-pagesEn directe
GET/v1/properties/{id}/gsc/keywords/detailEn directe
GET/v1/properties/{id}/gsc/pages/detailEn directe

AI Tracker

Llegeix els prompts que monitores per detectar mencions de marca a ChatGPT, Claude, Gemini i Perplexity.

GET/v1/properties/{id}/ai-tracker/promptsEn directe

Tasques

Llegeix i escriu tasques de SEO — connecta el teu tauler de tasques al teu propi stack de gestió de projectes.

GET/v1/properties/{id}/tasksEn directe
POST/v1/properties/{id}/tasksEn directe
GET/v1/properties/{id}/tasks/{ticketId}En directe
PATCH/v1/properties/{id}/tasks/{ticketId}En directe
POST/v1/properties/{id}/tasks/{ticketId}/commentsEn directe

GA4 i indexació

Trànsit, referrers d'IA i estat d'indexació. La connexió està a punt; els endpoints REST estan arribant.

GET/v1/properties/{id}/ga4/summaryAviat
GET/v1/properties/{id}/indexation/summaryAviat

Auditoria del lloc

Salut del rastreig, on-page, aspectes tècnics i llistes d'incidències — el conjunt complet de dades d'auditoria, exposat via REST.

GET/v1/properties/{id}/audit/summaryAviat
GET/v1/properties/{id}/audit/issuesAviat

Per què aquesta API

Feta per a productes, no per a scrapers

Una API REST de veritat amb autenticació Bearer, àmbits i límits de velocitat — que comparteix una capa de dades canònica amb l'MCP perquè les xifres mai no discrepin.

REST neta, JSON tipat

Recursos predictibles, verbs estàndard, respostes JSON tipades i errors conformes amb RFC (401 no autenticat, 403 scope_required, 429 amb Retry-After). Sense scraping d'HTML, sense exportacions fràgils.

Una capa de dades canònica

Els endpoints REST i les eines de l'MCP són germans sobre els mateixos proveïdors, amb la paritat provada a CI. El teu tauler i els teus agents d'IA sempre veuen els mateixos clics, impressions i posicions.

Claus autogestionades

Genera i revoca tokens Bearer des del teu tauler en segons. La mateixa clau sca_live_ autentica tant l'API REST com el servidor MCP — una credencial, dues superfícies.

Límits de velocitat documentats

60 sol·licituds per minut i 1,000 per hora per token, amb respostes 429 + Retry-After clares. Els límits de REST són un grup separat de l'ús de l'MCP — l'un mai no ofega l'altre.

Accés per àmbits

Àmbits de lectura i escriptura generals protegeixen cada endpoint, aplicats al tallafoc amb respostes d'step-up estàndard. Concedeix a cada clau només el que necessita.

Multitenant, aviat

Un flux de Google OAuth per tenant perquè els partners puguin connectar cadascuna de les propietats de GSC dels seus clients sota un mateix compte — amb un aïllament de dades estricte. En desenvolupament actiu; demana'ns accés anticipat.

Comença en 3 passos

De zero a la teva primera crida autenticada en un parell de minuts.

Genera una clau

Obre Tokens d'API al teu tauler i genera un token Bearer. Copia'l una vegada — comença per `sca_live_`.

Envia la capçalera

Passa `Authorization: Bearer sca_live_…` a cada sol·licitud a `https://api.seocrawl.ai/v1`. La mateixa clau també funciona amb el servidor MCP.

Obté dades

Crida `GET /v1/properties` per obtenir un `id` de propietat, i després accedeix a `/v1/properties/{id}/…` per al rendiment de GSC, els prompts d'AI Tracker o les tasques — i canalitza el JSON directament al teu producte, tauler o magatzem.

Tres maneres d'arribar a les teves dades

Les mateixes xifres, una superfície diferent — tria la que s'adapti a com construeixes.

API REST

Per a productes, taulers i pipelines de dades. Autenticació Bearer, JSON tipat, límits de velocitat. Ets en aquesta pàgina.

Servidor MCP

Per a agents d'IA — Claude, ChatGPT i qualsevol client MCP consulten les teves dades en llenguatge natural.

Explora l'MCP

Terminal i CLI

Per a scripts i CI/CD — controla les teves dades des de qualsevol agent de terminal compatible amb MCP.

Mira la CLI

Compara totes les integracions

Qui construeix sobre l'API

Equips que volen dades de SEO i de visibilitat a la IA dins dels seus propis sistemes.

SaaS i partners

Incrusta mètriques de SEO en directe a la interfície del teu propi producte. Ofereix als teus usuaris dades de Search Console i de visibilitat a la IA sense construir tu mateix els pipelines.

Agències

Canalitza les dades de cada client a un portal personalitzat, a Looker Studio o a la teva capa d'informes — una clau, totes les propietats, sense exportacions manuals.

Equips de dades

Porta les dades de GSC, de rànquing i d'AI Tracker al teu magatzem de manera programada. Combina-les amb els ingressos i construeix els models que necessiten els teus taulers.

Desenvolupadors

Automatitza comprovacions i alertes, sincronitza tasques amb la teva eina de gestió de projectes i connecta el monitoratge de visibilitat a la IA a les apps que ja despleges.

Preguntes freqüents

Realment hi ha una API SEO pública?

Sí — hi ha una API REST `/v1` autenticada amb Bearer en directe, que cobreix el rendiment de Search Console, les propietats, els prompts d'AI Tracker i les tasques, amb la referència pública completa publicada a api.seocrawl.ai/docs. Una cobertura més àmplia (GA4, exportació completa d'auditoria del lloc) i l'OAuth multitenant per a partners arriben aviat. Necessites alguna cosa que encara no està en directe? Demana'ns accés anticipat.

Com m'autentico?

Amb un token Bearer. Genera una clau `sca_live_` des del teu tauler i envia-la com a `Authorization: Bearer <key>` a cada sol·licitud. No hi ha cap ball d'OAuth per al teu propi compte — només la capçalera.

És la mateixa clau que l'MCP?

Sí. El mateix token autentica tant l'API REST com el servidor MCP, perquè tots dos llegeixen d'una mateixa capa de dades canònica. Una credencial, dues superfícies — i xifres idèntiques a totes dues.

Quins són els límits de velocitat?

60 sol·licituds per minut i 1,000 per hora per token. Si els superes, reps un `429` amb una capçalera `Retry-After`. Els límits de REST es controlen per separat de l'ús de l'MCP, de manera que tots dos mai no competeixen pel mateix pressupost.

Puc connectar les propietats de Search Console dels meus clients?

Aquest flux multitenant per a partners — un Google OAuth per tenant perquè puguis connectar cadascuna de les propietats de GSC dels teus clients sota el teu propi compte, amb un aïllament de dades estricte — està en desenvolupament actiu. Si estàs construint una integració de partner, posa't en contacte per obtenir accés anticipat.

Quines dades puc obtenir avui?

El resum de Search Console i les comparacions de períodes, les paraules clau i pàgines principals, el detall d'una sola paraula clau/pàgina, la teva llista de propietats, els prompts d'AI Tracker i lectura/escriptura completa de tasques. Reflecteix el que exposa l'MCP, via REST.

A punt per construir sobre les teves dades de SEO?

Genera una clau Bearer des del teu tauler i fes la teva primera crida REST en minuts — o parla amb nosaltres sobre l'accés per a partners i multitenant.

Aconsegueix la teva clau d'API Reserva una demo