Amb un token Bearer. Genera una clau sca_live_ des del teu tauler i envia-la com a Authorization: Bearer a cada petició. Per al teu propi compte no hi ha cap ball d'OAuth: només la capçalera.

API de Search Console · REST v1 · Documentació en directe

API de Google Search Console per al teu propi stack

Les dades de rendiment del teu Search Console, sobre un endpoint REST net.

Porta clics, impressions, CTR i posició mitjana — per consulta, pàgina i interval de dates — directament des de Google Search Console al teu producte, al teu tauler o al teu data warehouse. Connecta GSC una vegada dins de SEOcrawl AI, genera una clau Bearer des del teu tauler i crida la REST /v1 — sense haver de muntar tu l'OAuth de Google. És la mateixa capa de dades canònica que alimenta l'MCP de SEOcrawl AI, així que les teves xifres sempre quadren. La cobertura d'indexació i la inspecció d'URL arriben aviat a REST; per MCP ja hi són.

Aconsegueix la teva clau d'API Consulta la documentació Explora l'MCP

API de Google Search Console de SEOcrawl AI — una petició curl i la resposta JSON tipada amb clics, impressions, CTR i posició.

Exemples de peticions a l'API de Google Search Console en cURL, JavaScript i Python.

Resol una propietat. Consulta les dades de GSC.

Genera un token Bearer des del teu tauler i passa'l a la capçalera Authorization. Resol una sola vegada l'id de la propietat de Search Console i després consulta'n el rendiment per REST. La mateixa clau serveix per a l'API REST i per 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

Totes les mètriques de Search Console, per REST

Clics, impressions, CTR i posició mitjana — per consulta, pàgina, interval de dates i període contra període. Tots els endpoints van lligats a una propietat: primer resol el seu id i després llegeix-ne les dades de Search Console. Aquests grups de GSC ja són en directe a la v1; la cobertura d'indexació i la inspecció d'URL avui són a l'MCP i arriben a REST tot seguit.

Propietats

Llista les propietats de Search Console connectades al teu compte. Fes servir l'id de cada propietat a la ruta de tots els endpoints de GSC.

GET/v1/propertiesEn directe

Rendiment

Clics, impressions, CTR i posició mitjana totals per a un interval de dates — més la variació respecte al període anterior en aquesta mateixa finestra.

GET/v1/properties/{id}/gsc/summaryEn directe
GET/v1/properties/{id}/gsc/compareEn directe

Consultes

Les consultes de cerca per les quals apareixes, amb mètriques per consulta — i l'històric diari complet de qualsevol paraula clau.

GET/v1/properties/{id}/gsc/top-keywordsEn directe
GET/v1/properties/{id}/gsc/keywords/detailEn directe

Pàgines

Els URL amb millor rendiment i les seves mètriques de Search Console — i el desglossament diari complet de qualsevol pàgina.

GET/v1/properties/{id}/gsc/top-pagesEn directe
GET/v1/properties/{id}/gsc/pages/detailEn directe

Cobertura d'indexació

Què indexa realment Google: estats de cobertura i històric d'indexació. Avui disponible a l'MCP; els endpoints REST s'estan desplegant.

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

Inspecció d'URL

Inspecció URL a URL — cobertura, darrer rastreig i estat d'indexació d'una pàgina concreta. Ja disponible per MCP; REST arriba després.

GET/v1/properties/{id}/url-inspectionAviat

Dades reals de Search Console, pensades per a productes

El teu rendiment real a Google Search Console — no estimacions de tercers — sobre una API REST neta, amb autenticació Bearer i límits d'ús, compartint una única capa de dades canònica amb l'MCP perquè les xifres no es contradiguin mai.

Directe des de Search Console

Clics, impressions, CTR i posició mitjana extrets de la teva pròpia propietat de GSC — les xifres reals que reporta Google, no estimacions modelades ni obtingudes amb scraping. Recursos predictibles, verbs estàndard, JSON tipat i errors conformes als RFC.

Sense muntar l'OAuth de Google

Connecta Search Console una vegada dins de SEOcrawl AI i llegeix-lo amb una única clau Bearer sca_live_. Oblida't del projecte a Google Cloud, la pantalla de consentiment i la renovació de tokens: crea i revoca claus des del teu tauler en segons.

Una única capa de dades canònica

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

Granularitat per consulta i per pàgina

Llegeix els totals d'una propietat o baixa al detall: top de consultes, top de pàgines, la tendència diària d'una paraula clau o l'històric d'un URL — les mateixes dimensions que veus a Search Console, accessibles per HTTP.

Comparativa de períodes inclosa

Demana un rang (last_7_days, last_28_days, last_3_months, last_year) o dates from/to explícites i rep la comparació entre períodes de sèrie — sense una segona crida ni càlculs de dates al client per quadrar les variacions.

Límits d'ús documentats

60 sol·licituds per minut i 1.000 per hora i token, amb respostes 429 + Retry-After clares. Els límits de REST són una bossa separada del consum de l'MCP: l'un mai deixa l'altre sense quota.

Comença en 3 passos

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

Genera una clau

Connecta Search Console a SEOcrawl AI, obre Tokens d'API i genera un token Bearer. Copia'l una sola vegada: comença per sca_live_.

Resol una propietat

Crida GET /v1/properties amb Authorization: Bearer sca_live_… per obtenir l'id (un UUID) de la propietat de Search Console que vulguis llegir.

Consulta les dades de GSC

Crida /v1/properties/{id}/gsc/summary?range=last_28_days per als totals, o /gsc/top-keywords, /gsc/top-pages i els endpoints /detail — i envia el JSON directament al teu producte, al teu tauler o al teu warehouse.

Tres maneres d'arribar a les teves dades de Search Console

Les mateixes xifres de GSC, superfícies diferents: tria la que s'adapti a com construeixes.

API REST

Per a productes, taulers i pipelines de dades. Autenticació Bearer, JSON tipat, límits d'ús. Ja hi ets: l'API SEO completa hi afegeix endpoints de posicions i de visibilitat a la IA amb la mateixa clau.

Servidor MCP

Per a agents d'IA: Claude, ChatGPT i qualsevol client MCP pregunten a les teves dades de Search Console en llenguatge natural.

Explora l'MCP

Terminal i CLI

Per a scripts i CI/CD: governa les teves dades de GSC des de qualsevol agent de terminal compatible amb MCP.

Mira la CLI

Compara totes les integracions

Qui construeix sobre l'API de Search Console

Equips que volen dades reals de rendiment de GSC dins dels seus propis sistemes.

Agències

Porta les dades de Search Console de cada client a un portal propi, a Looker Studio o a la teva capa de reporting — una clau, totes les propietats, sense exportacions manuals de GSC.

SaaS i partners

Integra mètriques de Search Console en directe dins de la interfície del teu propi producte. Ofereix als teus usuaris clics, impressions i posicions sense cablejar tu l'API de Google.

Equips de dades

Fes aterrar clics, impressions, CTR i posició de GSC al teu warehouse de manera programada. Creua'ls amb els ingressos i construeix els models que necessiten els teus taulers.

Desenvolupadors

Automatitza el monitoratge de consultes i pàgines, avisa davant de caigudes de posicions i connecta les dades de Search Console amb les apps i els fluxos que ja tens en producció.

Preguntes freqüents

Aquesta és l'API oficial de Search Console de Google?

No. És l'API REST pròpia de SEOcrawl AI, autenticada amb Bearer, sobre les dades de Search Console que ja has connectat al teu compte. Connectes GSC una vegada dins de SEOcrawl AI i a partir d'aquí llegeixes clics, impressions, CTR i posició amb una única clau sca_live_ — sense crear un projecte a Google Cloud, una pantalla de consentiment OAuth ni una renovació de tokens. Les xifres són les teves xifres reals de Search Console; l'API i l'autenticació són nostres.

Quines dades de Search Console puc obtenir avui?

Els totals d'un interval de dates (clics, impressions, CTR, posició mitjana), les comparatives entre períodes, el teu top de consultes i de pàgines amb mètriques, i el detall diari complet d'una paraula clau o d'una pàgina — a més de la llista de les teves propietats connectades. La cobertura d'indexació i la inspecció d'URL en directe ja són disponibles per MCP; els seus endpoints REST arriben tot seguit. I si prefereixes llegir el compte en comptes de consultar-lo, l'auditoria de Google Search Console cobreix les mateixes dades en un sol prompt.

Com m'autentico?

Amb un token Bearer. Genera una clau sca_live_ des del teu tauler i envia-la com a Authorization: Bearer <clau> a cada petició. Per al teu propi compte no hi ha cap ball d'OAuth: només la capçalera.

Quins intervals de dates s'admeten?

Tots els endpoints de GSC accepten o bé un range (last_7_days, last_28_days, last_3_months o last_year) o bé un parell from/to explícit. L'endpoint gsc/compare retorna aquesta mateixa finestra comparada amb el període anterior, així que obtens les variacions sense una segona crida.

Quins són els límits d'ús?

60 sol·licituds per minut i 1.000 per hora i token. Si els superes reps un 429 amb capçalera Retry-After. Els límits de REST es comptabilitzen a part del consum de l'MCP, així que mai no competeixen per la mateixa bossa.

És la mateixa clau i les mateixes dades que l'MCP?

Sí. El mateix token sca_live_ autentica l'API REST i el servidor MCP, i tots dos llegeixen d'una única capa de dades canònica — així que les xifres de Search Console que obtens per REST són idèntiques a les que veuen els teus agents d'IA per MCP. Una credencial, dues superfícies.

A punt per construir sobre les teves dades de Search Console?

Connecta GSC una vegada, genera una clau Bearer des del teu tauler i fes la teva primera crida REST a Search Console en minuts — o explora l'MCP per a agents d'IA.

Aconsegueix la teva clau d'API Consulta la documentació Reserva una demo