Kulcsszópozíció ellenőrzése a Google API-val (2026-os útmutató)

Gyors kvíz

Hogyan kövesd nyomon a Google-es pozícióidat?

1. kérdés, összesen 425%

Miért szeretnéd követni a pozícióidat?

Hogy lássam, hol állokHogy javítsam őketHogy eredményt mutassak az ügyfeleknek vagy a vezetőnek

A kulcsszópozíció ellenőrzése a Google API-val az a feladat, amely megoldottnak tűnik, amíg valóban neki nem látsz. Nincs rankings.get() végpont, és a két Google-API, amelyhez az emberek először nyúlnak, a feltett kérdéstől finoman eltérő kérdésre válaszol. A Search Console Search Analytics dokumentáció a megfelelő kiindulópont, feltéve, hogy érted, mit jelent ott a „pozíció”.

Van a Google hivatalos kulcsszórangsorolási API-ja?

Nincs. A Google soha nem adott ki olyan API-t, amely elfogad egy kulcsszót, és visszaadja az élő pozíciódat a google.com-on. Ez szándékos: a keresési eredményoldal automatizált lekérdezését a Google feltételei tiltják, a cégnek pedig nincs üzleti érdeke, hogy rangsorkövető infrastruktúrát biztosítson.

Helyette három részleges út létezik, mindegyiknek kemény határa van:

Hogyan kapok kulcsszópozíciókat a Search Console API-ból?

Kérdezd le a searchAnalytics végpontot a query dimenzióval, és olvasd ki a position mezőt. Ez saját forrású adat, közvetlenül a Google-től, ingyenes, és nincs kulcsszóhatár: minden olyan lekérdezést megkapsz, amelyre a webhelyed kapott megjelenést.

A működő kérés Pythonban:

from google.oauth2 import service_account
from googleapiclient.discovery import build

creds = service_account.Credentials.from_service_account_file(
    "service-account.json",
    scopes=["https://www.googleapis.com/auth/webmasters.readonly"],
)
service = build("searchconsole", "v1", credentials=creds)

response = service.searchanalytics().query(
    siteUrl="https://example.com/",
    body={
        "startDate": "2026-07-01",
        "endDate": "2026-07-31",
        "dimensions": ["query", "page"],
        "rowLimit": 25000,
    },
).execute()

for row in response.get("rows", []):
    query, page = row["keys"]
    print(f"{row['position']:.1f}  {query}  ->  {page}")

A három korlát, amely becsapja az embereket

• A pozíció átlag, nem rangsor. A 7,4-es érték nem azt jelenti, hogy a 7. helyen állsz; azt jelenti, hogy a megjelenések átlagosan a 7,4. pozíció körül oszlottak el, eszközök és helyszínek szerint a 3. és a 15. pozíció között is szóródhattak.
• Csak a saját webhelyed. Versenytárs pozícióját nem látod. A Search Console tervezése szerint tulajdonhoz kötött API.
• A nulla megjelenésű kulcsszavak láthatatlanok. Ha a 60. helyen állsz, és senki sem görgetett odáig, a lekérdezés egyáltalán nem jelenik meg az adatokban.

A harmadik pont az, amely csendben tönkreteszi a jelentéseket. Egy kulcsszó, amelyre még nem jutottál be az első oldalakra, egyszerűen nem létezik a Search Console-ban, ezért ezzel az API-val önmagában lehetetlen mérni az előrehaladást a 60. helyről a 20. helyre.

Ellenőrizhetem a rangsorokat a Custom Search JSON API-val?

Technikailag igen, érdemben nem. A Custom Search JSON API megköveteli, hogy először Programmable Search Engine-t hozz létre. Még akkor is, ha az egész webre keresésre van beállítva, saját rangsorolást és saját korlátozásokat alkalmaz, így a visszaadott sorrend nem azonos azzal, amelyet a google.com ad vissza.

Az ingyenes szinten napi 100 lekérdezésre korlátozott, a fizetős használat pedig ezer lekérdezésenként, napi plafonnal számláz. Néhány kulcsszóra, amelyet alkalmanként ellenőrzöl, használható. Rangsorkövetőként olyan számokat ad, amelyek hitelesnek látszanak, pedig csendben hibásak, ez pedig rosszabb, mint ha nincs adat.

Mi a helyzet a Google közvetlen lekaparásával?

Ne tedd. A Google Keresés engedély nélküli automatizált lekérdezése ellentétes a Google Szolgáltatási feltételeivel, és bármekkora mennyiségnél IP-blokkolást és CAPTCHA-falakat von maga után. A szabályzati kérdésen túl a mérnöki valóság is kellemetlen: az eredmények személyre szabottak, helyhez igazodók, és egyre több AI-funkcióval épülnek fel, így egy lekaparással kapott „pozíció” adatközponttól, helyszíntől és munkamenettől függően változik, még akkor is, ha a webhelyeden semmi nem változott.

Ha versenytársak pozíciójára van szükséged, a kereskedelmi SERP API az az út, amely a szolgáltató saját szerződései szerint is legális, és működés közben is stabil. Ez fizetős tétel, és ez a költség annak az adatnak az őszinte ára, amelyet a Google nem ad ingyen. Az olyan vállalkozásoknak, amelyeknek ez a folyamat házon kívül kell, hogy felépüljön és fusson, általában szakembert hívnak; a Franciaország legjobb 10 adatelemzési ügynöksége összehasonlítás olyan szolgáltatókat sorol fel, akik ilyen jelentéskészítést állítanak be.

Mit érdemes valójában felépíteni?

A legtöbb csapatnak a pragmatikus architektúra hibrid, és így néz ki:

• A Search Console API a gerinc. Ingyenes, korlátlan kulcsszó, saját forrású, és az egyetlen forrás, amely megmondja, mire kapsz ténylegesen megjelenést.
• Egy SERP API egy kis, válogatott kulcsszókészletre. A húsz-harminc kereskedelmileg kritikus kifejezésedre, napi ellenőrzéssel, a versenytársak pozícióit is beleértve.
• Egy AI-láthatósági réteg. Egyre inkább nem csak az a kérdés, hogy „milyen pozícióban vagyok”, hanem hogy „idéznek-e, amikor valaki asszisztenst kérdez”. A klasszikus rangsor-API-k erre egyiket sem adják meg.

Akik inkább nem maguk tervezik meg ezt, általában szakemberre bízzák; a Franciaország legjobb 10 SEO-ügynöksége összehasonlítás olyan szolgáltatókat mutat be, akik ügyfeleknek kezelik ezt a jelentéskészítési rendszert.

Ez az utolsó pont nem jövőbeli gond. Ha egy AI-válasz a felületen megoldja a lekérdezést, a tizedik és a harmadik pozíció ugyanarra a kimenetelre fut össze: nincs kattintás. A hivatkozások követése a pozíciók mellett az, amire a Search Console MCP-szerverünk és az AI-láthatósági platformunk készült, a beállítást pedig a dokumentáció végig leírja.

Következtetés

Nincs hivatalos Google API az élő kulcsszópozíciókhoz: a saját, átlagolt adatokhoz használd a Search Console API-t, a pontos és versenytárs-pozíciókhoz egy harmadik féltől származó SERP API-t, a rangsorolási munkához pedig egyáltalán ne használd a Custom Search JSON API-t. A leggyakoribb hiba itt a rossz eszközre építkezni, és ez magabiztosan pontatlan műszerfalat eredményez.

Ha nem szeretnéd magad felépíteni és karbantartani ezt a folyamatot, a Sorank egy helyen köti össze a Search Console-odat, és követi az AI-hivatkozásokat.