Cum verifici poziția cuvintelor cheie cu ajutorul API-ului Google (ghid 2026)

Test rapid

Cum ar trebui să îți urmărești pozițiile pe Google?

Întrebarea 1 din 425%

De ce vrei să îți urmărești pozițiile?

Ca să văd unde mă situezCa să le îmbunătățescCa să arăt rezultate clienților sau unui manager

Încercarea de a verifica poziția cuvintelor cheie cu API-ul Google este una dintre sarcinile care par rezolvate până când încerci efectiv. Nu există niciun endpoint rankings.get(), iar cele două API-uri Google la care se apelează primele răspund fiecare la o întrebare subtil diferită de cea pusă. Documentația Search Analytics din Search Console este locul potrivit de pornire, cu condiția să înțelegi ce înseamnă „poziția” acolo.

Are Google un API oficial pentru clasarea cuvintelor cheie?

Nu. Google nu a lansat niciodată un API care primește un cuvânt cheie și returnează poziția ta live pe google.com. Este o decizie deliberată: interogarea automată a paginii de rezultate este interzisă de termenii Google, iar compania nu are niciun interes comercial să ofere infrastructură de urmărire a clasărilor.

Există în schimb trei căi parțiale, fiecare cu o limită fermă:

Cum obțin pozițiile cuvintelor cheie din API-ul Search Console?

Interoghezi endpoint-ul searchAnalytics cu dimensiunea query și citești câmpul position. Acestea sunt date proprii, venite direct de la Google, sunt gratuite și nu au limită de cuvinte cheie: primești fiecare interogare pentru care site-ul tău a primit impresii.

Cererea funcțională, în Python:

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}")

Cele trei limitări care prind pe nepregătite

• Poziția este o medie, nu o clasare. O valoare de 7,4 nu înseamnă că ești pe poziția 7; înseamnă că impresiile s-au distribuit pe poziții a căror medie este 7,4, posibil cu valori între 3 și 15 în funcție de dispozitive și locații.
• Doar site-ul tău. Nu există nicio modalitate de a vedea poziția unui concurent. Search Console este, prin construcție, un API limitat la proprietate.
• Cuvintele cheie fără impresii sunt invizibile. Dacă te clasezi pe poziția 60 și nimeni nu a derulat atât de jos, interogarea nu apare deloc în date.

Al treilea punct este cel care strică discret raportarea. Un cuvânt cheie pentru care nu ai reușit încă să intri în primele pagini pur și simplu nu există în Search Console, ceea ce face imposibil să măsori progresul de la poziția 60 la poziția 20 folosind doar acest API.

Pot folosi API-ul Custom Search JSON ca să verific clasările?

Din punct de vedere tehnic, da; din punct de vedere al sensului, nu. API-ul Custom Search JSON cere mai întâi crearea unui motor de căutare programabil. Chiar și configurat să caute pe întregul web, aplică propria clasare și propriile restricții, așa că ordinea pe care o returnează nu este ordinea returnată de google.com.

Este limitat și la 100 de interogări pe zi în planul gratuit, iar utilizarea plătită se facturează la o mie de interogări, cu un plafon zilnic. Pentru câteva cuvinte cheie verificate din când în când, este utilizabil. Ca instrument de urmărire a clasărilor, produce cifre care par autoritare și sunt discret greșite, ceea ce este mai rău decât a nu avea deloc date.

Dar extragerea directă de date din Google?

Nu o face. Interogarea automată a Căutării Google fără permisiune contravine Termenilor de serviciu Google și, la orice volum, atrage blocarea IP-urilor și zidurile de CAPTCHA. Dincolo de aspectul politicii, realitatea tehnică este neplăcută: rezultatele sunt personalizate, localizate și din ce în ce mai des asamblate cu funcții AI, așa că o „poziție” extrasă variază în funcție de centrul de date, locație și sesiune, chiar dacă nimic din site-ul tău nu s-a schimbat.

Dacă ai nevoie de pozițiile concurenților, un API SERP comercial este calea care este, în același timp, legală conform acordurilor furnizorului și stabilă din punct de vedere operațional. Este o cheltuială plătită, iar acest cost este prețul onest al datelor pe care Google nu le oferă gratuit. Afacerile care au nevoie ca această linie de date să fie construită și monitorizată fără să angajeze intern aduc de obicei un specialist; comparația noastră a celor mai bune 10 agenții de analiză a datelor din Franța enumeră furnizori care configurează acest tip de raportare.

Ce ar trebui să construiești de fapt?

Pentru majoritatea echipelor, arhitectura pragmatică este una hibridă, care arată așa:

• API-ul Search Console ca bază. Gratuit, fără limită de cuvinte cheie, cu date proprii și singura sursă care îți spune pentru ce primești efectiv impresii.
• Un API SERP pentru un set mic, selecționat de cuvinte cheie. Cei douăzeci sau treizeci de termeni critici din punct de vedere comercial, verificați zilnic, inclusiv pozițiile concurenților.
• Un strat de vizibilitate în AI. Din ce în ce mai mult, întrebarea nu este doar „pe ce poziție sunt”, ci și „sunt citat când cineva întreabă un asistent”. API-urile clasice de poziții nu răspund la nimic din toate acestea.

Echipele care preferă să nu construiască singure această arhitectură o predau, de obicei, unui specialist; comparația noastră a celor mai bune 10 agenții SEO din Franța prezintă furnizori care gestionează acest set de raportare pentru clienți.

Ultimul punct nu este o preocupare de viitor. Când un răspuns AI rezolvă interogarea direct în interfață, poziția zece și poziția trei ajung la același rezultat, adică niciun clic. Urmărirea citărilor alături de poziții este ceea ce urmăresc să facă serverul nostru MCP pentru Search Console și platforma noastră de vizibilitate în AI, iar documentația acoperă configurarea de la cap la coadă.

Concluzie

Nu există un API oficial Google pentru pozițiile live ale cuvintelor cheie: folosește API-ul Search Console pentru datele tale mediate, un API SERP terț pentru pozițiile exacte și competitive și renunță complet la API-ul Custom Search JSON pentru lucrul la clasări. Construirea pe baza celui greșit este cea mai frecventă greșeală aici și produce un tablou de bord care este sigur pe sine și greșit.

Dacă preferi să nu construiești și să nu întreții singur acest flux, Sorank îți conectează Search Console și urmărește citările AI într-un singur loc.