Hur använder jag Google Search Console API?

Q: Hur använder jag Google Search Console API?

Skapa ett Cloud-projekt, aktivera API:et, auktorisera med OAuth och hämta sedan prestandadata, URL-inspektion och sitemaps. Här är stegen och kvoterna.

Skapa ett projekt i Google Cloud console, aktivera Google Search Console API, skapa OAuth 2.0-uppgifter och logga in med ett Google-konto som har åtkomst till egenskapen. Därefter kan du skicka förfrågningar till fyra resurser: Search Analytics för klick, visningar, CTR och position, URL Inspection för indexeringsstatus, Sitemaps samt Sites. Enbart API-nycklar fungerar inte: varje anrop kräver en OAuth-token, och kvoter begränsar hur mycket du kan begära.

Vad API:et omfattar och vad det inte gör

Resurs	Metoder	Används för
Search Analytics	`query`	Prestandarader per sökfråga, sida, land, enhet, sökutseende, datum eller timme
URL Inspection	`index.inspect`	Den indexerade versionen av en enskild URL: täckning, senaste genomsökning, canonical-adresser
Sitemaps	`list`, `get`, `submit`, `delete`	Hantering av de sitemaps som en egenskap har skickat in
Sites	`list`, `get`, `add`, `delete`	Egenskaperna i det inloggade kontot

Det är hela API:et. Länkar, Crawl stats, rapporten Sidindexering och rapporten Core Web Vitals saknar endpoint och finns därför bara kvar i Search Console-gränssnittet. URL Inspection visar vad som finns i Googles index, inte ett liveprov av sidan.

Konfigurera åtkomst

Skapa eller välj ett projekt i Google Cloud console.
Aktivera Google Search Console API för projektet.
Konfigurera OAuth-samtyckesskärmen och skapa ett OAuth-klient-ID.
Begär en behörighet (scope): https://www.googleapis.com/auth/webmasters.readonly för att läsa, eller https://www.googleapis.com/auth/webmasters om du även vill skicka in eller ta bort sitemaps.
Logga in med ett konto som har behörighet till egenskapen. För att läsa prestandadata krävs minst läsbehörighet. API:et ser exakt det som kontot ser.

Din första Search Analytics-förfrågan

POST https://www.googleapis.com/webmasters/v3/sites/sc-domain%3Aexample.com/searchAnalytics/query
Authorization: Bearer ACCESS_TOKEN
Content-Type: application/json

{
  "startDate": "2026-09-01",
  "endDate": "2026-09-30",
  "dimensions": ["query", "page"],
  "type": "web",
  "rowLimit": 25000,
  "startRow": 0
}

Webbplatsen anges i sökvägen, URL-kodad: sc-domain:example.com för en domänegenskap, eller det exakta prefixet med avslutande snedstreck, till exempel https://www.example.com/, för en egenskap med URL-prefix. De viktigaste fälten:

Datum är inklusive och anges i Pacific Time.
type är som standard web. Övriga värden är image, video, news, googleNews och discover. Varje typ kräver en egen förfrågan.
Filter läggs i dimensionFilterGroups, med operatorer från equals och contains till includingRegex och excludingRegex (RE2-syntax).
rowLimit kan vara mellan 1 och 25 000 (standard 1 000). Med startRow bläddrar du igenom resten.
dataState är som standard final. all tar med färska, ofullständiga dagar och hourly_all fungerar tillsammans med dimensionen hour.

Varje rad returnerar keys, clicks, impressions, ctr (0 till 1) och position, sorterade efter klick om du inte grupperar på datum.

Gränserna som styr hur du skriver koden

50 000 rader per dag och söktyp. Bläddra med startRow i steg om 25 000 och sluta när svaret är tomt. För att få ut så mycket som möjligt frågar du en dag i taget.
Belastningskvot. Att gruppera eller filtrera på både sida och sökfråga är den dyraste förfrågan, och långa datumintervall kostar mer än korta. Om du överskrider kortsiktskvoten ber Google dig vänta i 15 minuter.
Förfrågningsfrekvens. 1 200 förfrågningar per minut per webbplats och per användare, samt 40 000 per minut och 30 000 000 per dag per projekt.
Kvot för URL Inspection. 2 000 inspektioner per dag och 600 per minut för varje egenskap.
16 månaders historik. Data finns vanligtvis tillgänglig två till tre dagar efter dagens slut.
Raderna summerar inte till totalerna. Sällsynta sökfrågor utelämnas från rader på sökfrågenivå, och gruppering på sida räknar visningar på ett annat sätt än gruppering på egenskap. Läs därför totaler från en förfrågan utan dimensionen query.

Vanliga misstag

Om du använder http:// när egenskapen är https://, eller utelämnar det avslutande snedstrecket, får du ett behörighetsfel även när kontot har åtkomst.
Om du i URL Inspection anger en URL utanför egenskapen avvisas anropet: URL:en måste ligga under det siteUrl du skickar med.
En månad som grupperas på sökfråga och sida i ett enda anrop returnerar bara de översta raderna. Dagliga förfrågningar ger fler rader.

Så hjälper AutoPSEO

Om du helst slipper underhålla OAuth och paginering ansluter AutoPSEO via Google-inloggning och erbjuder samma data via sitt eget REST API på /v1 (med ett OpenAPI 3.1-dokument) och en MCP-server, auktoriserad med en API-nyckel från Account → API keys. Skrivskyddade nycklar finns, endpointen för search analytics returnerar upp till 5 000 rader per anrop, och appens verktyg för URL Inspection håller reda på Googles kvot på 2 000 per dag åt dig. Se MCP och API-nycklar. Om du vill spara data längre än 16 månader utan att skriva en egen pipeline kan du läsa hur länge Search Console sparar data.

Källor: Googles API-referens, Search Analytics query-metod, användningsgränser, hämta all din data och auktoriseringsguide.