Google API ile Anahtar Kelime Sırası Nasıl Kontrol Edilir (2026 Rehberi)

Google API ile anahtar kelime sırasını kontrol etmeye çalışmak, gerçekten denemeye kalkana dek çözülmüş bir problem gibi görünen görevlerden biridir. Bir rankings.get() uç noktası yok ve insanların ilk akla getirdiği iki Google API'sinin her biri, sorulandan ince biçimde farklı bir soruyu yanıtlar. Search Console Search Analytics belgeleri başlamak için doğru yerdir, yeter ki oradaki “konum”un ne anlama geldiğini anlayın.

Google'ın resmi bir anahtar kelime sıralama API'si var mı?

Hayır. Google hiçbir zaman bir anahtar kelime kabul edip google.com'daki canlı konumunuzu döndüren bir API yayımlamadı. Bu kasıtlıdır: arama sonuçları sayfasının otomatik sorgulanması Google'ın şartlarıyla yasaklanmıştır ve şirketin sıralama takibi altyapısı sağlamakta ticari bir çıkarı yoktur.

Bunun yerine var olanlar, her biri kesin bir sınırı olan üç kısmi yoldur:

Search Console API'sinden anahtar kelime konumlarını nasıl alırım?

searchAnalytics uç noktasını query boyutuyla sorgulayın ve position alanını okuyun. Bu, doğrudan Google'dan gelen birinci taraf verisidir, ücretsizdir ve anahtar kelime sınırı yoktur; sitenizin gösterim aldığı her sorguyu elde edersiniz.

Python'da çalışan istek:

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

İnsanları yakalayan üç sınırlama

• Konum bir ortalamadır, sıra değil. 7,4 değeri 7. sırada olduğunuz anlamına gelmez; gösterimlerin ortalaması 7,4 olan konumlara dağıldığı, cihazlara ve konumlara göre muhtemelen 3 ile 15 arasında değiştiği anlamına gelir.
• Yalnızca siteniz. Bir rakibin konumunu görmenin yolu yok. Search Console tasarım gereği mülk kapsamlı bir API'dir.
• Sıfır gösterimli anahtar kelimeler görünmezdir. 60. sıradaysanız ve kimse o kadar aşağı kaydırmadıysa, sorgu veride hiç görünmez.

Bu üçüncü nokta, raporlamayı sessizce bozan noktadır. İlk sayfalara henüz giremediğiniz bir anahtar kelime Search Console'da basitçe yoktur; bu da yalnızca bu API ile 60. konumdan 20. konuma ilerlemeyi ölçmeyi imkansız kılar.

Sıralamaları kontrol etmek için Custom Search JSON API'sini kullanabilir miyim?

Teknik olarak evet, anlamlı olarak hayır. Custom Search JSON API'si önce bir Programmable Search Engine oluşturmanızı gerektirir. Tüm web'de arama yapacak şekilde yapılandırılsa bile kendi sıralamasını ve kendi kısıtlamalarını uygular; bu yüzden döndürdüğü sıra google.com'un döndürdüğü sıra değildir.

Ayrıca ücretsiz katmanda günde 100 sorguyla sınırlıdır; ücretli kullanım bin sorgu başına faturalandırılır ve günlük bir üst sınır vardır. Ara sıra kontrol edilen bir avuç anahtar kelime için kullanılabilir. Bir sıralama takipçisi olarak ise yetkili görünen ve sessizce yanlış olan sayılar üretir; bu, hiç veriye sahip olmamaktan daha kötüdür.

Peki Google'ı doğrudan taramaya ne dersiniz?

Yapmayın. Google Arama'nın izinsiz otomatik sorgulanması Google'ın Hizmet Şartları'na aykırıdır ve herhangi bir hacimde IP engellemesini ve CAPTCHA duvarlarını davet eder. Politika sorusunun ötesinde mühendislik gerçeği hoş değildir: sonuçlar kişiselleştirilir, yerelleştirilir ve giderek yapay zeka özellikleriyle bir araya getirilir; bu nedenle taranan bir “konum”, sitenizde hiçbir şey değişmemiş olsa bile veri merkezine, konuma ve oturuma göre değişir.

Rakip konumlarına ihtiyacınız varsa, ticari bir SERP API'si hem sağlayıcının kendi sözleşmeleri kapsamında yasal hem de operasyonel olarak kararlı olan yoldur. Bu ücretli bir kalemdir ve bu maliyet, Google'ın vermediği verinin dürüst bedelidir. Bu hattın kurulmasını ve izlenmesini şirket içinde işe alım yapmadan isteyen işletmeler genellikle bir uzmanla çalışır; Fransa'daki en iyi 10 veri analitiği ajansı karşılaştırmamız bu tür raporlamayı kuran sağlayıcıları listeler.

Gerçekte ne kurmalısınız?

Çoğu ekip için pragmatik mimari bir hibrittir ve şöyle görünür:

• Omurga olarak Search Console API'si. Ücretsiz, sınırsız anahtar kelime, birinci taraf ve gerçekte hangi sorgularda gösterim aldığınızı söyleyen tek kaynak.
• Küçük, seçilmiş bir anahtar kelime kümesi için bir SERP API'si. Ticari açıdan kritik yirmi ya da otuz terimi, rakip konumları dahil, günlük kontrol edin.
• Bir yapay zeka görünürlüğü katmanı. Soru giderek yalnızca “hangi sıradayım” değil, “biri bir asistana sorduğunda alıntılanıyor muyum” haline geliyor. Klasik sıralama API'leri bunların hiçbirini yanıtlamaz.

Bunu kendileri tasarlamak istemeyen ekipler genellikle bir uzmana devreder; Fransa'daki en iyi 10 SEO ajansı karşılaştırmamız, bu raporlama yığınını müşteriler için yöneten sağlayıcıları tanıtır.

Bu son nokta gelecekteki bir endişe değil. Bir yapay zeka yanıtı sorguyu arayüzün içinde çözdüğünde, onuncu sıra ile üçüncü sıra aynı sonuçta buluşur: tıklama yok. Alıntıları konumlarla birlikte izlemek, Search Console MCP sunucumuzun ve yapay zeka görünürlüğü platformumuzun yapmak üzere kurulduğu şeydir ve belgeler kurulumu baştan sona ele alır.

Sonuç

Canlı anahtar kelime konumları için resmi bir Google API'si yok: kendi ortalaması alınmış verileriniz için Search Console API'sini, kesin ve rekabetçi konumlar için üçüncü taraf bir SERP API'sini kullanın ve sıralama çalışmaları için Custom Search JSON API'sini tamamen atlayın. Yanlış olanın üzerine kurmak buradaki en yaygın hatadır ve kendinden emin biçimde hatalı bir panel üretir.

Bu hattı kendiniz kurmak ve bakımını yapmak istemiyorsanız, Sorank Search Console'unuzu bağlar ve yapay zeka alıntılarını tek bir yerde takip eder.