← Bloga dön

2026'da Google Search API Nasıl Kullanılır: Tam Kılavuz

Bir Google Search API'yi baştan sona kullanmayı öğrenin — kimlik doğrulama, parametreler, ayrıştırma, sayfalama ve maliyet kontrolü — kopyala-yapıştır Python, Node.js ve curl koduyla.

2 dk okuma

Bu, bir Google Search API’yi kullanmaya yönelik pratik, baştan sona kılavuzdur: kimlik doğrulayın, bir sorgu gönderin, JSON’u okuyun, sayfalama yapın, hataları yönetin ve maliyetleri düşük tutun. Örnekler serp.cheap (2026’nın en ucuz seçeneği) kullanır, ancak kavramlar herhangi bir SERP API için geçerlidir.

1. Bir API anahtarı alın

En hızlı yol, app.serp.cheap/login adresinden doğrudan ücretsiz kaydolmaktır — kredi kartı gerekmez, 100 ücretsiz arama dahildir. Anında bir API anahtarı alır, onu X-API-Key başlığında iletirsiniz; krediler 12 ay geçerlidir. Tercih ederseniz, alternatif olarak Apify veya RapidAPI üzerinden de kaydolabilirsiniz.

2. Tek satırda uç nokta

POST https://api.serp.cheap/v1/search
ParametreVarsayılanAçıklama
qzorunluArama sorgusu
gl"us"Ülke (ör. br, gb, de)
hlülke varsayılanıArayüz dili geçersiz kılma
page1Sonuç sayfası (1’den başlar)
tbsyokZaman filtresi: qdr:h, qdr:d, qdr:w

Tam referans: Google Search API parametreleri.

3. İlk isteğiniz

curl https://api.serp.cheap/v1/search \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q": "best electric cars 2026", "gl": "us", "page": 1}'
import requests

r = requests.post(
    "https://api.serp.cheap/v1/search",
    headers={"X-API-Key": "YOUR_KEY"},
    json={"q": "best electric cars 2026", "gl": "us", "page": 1},
)
r.raise_for_status()
data = r.json()
for item in data["organic"]:
    print(item["position"], item["title"], item["link"])

Dile özgü kılavuzlar: Python · Node.js · PHP · Go · curl.

4. Yanıtı okuyun

{
  "search": "best electric cars 2026",
  "page": 1,
  "organic": [
    {
      "position": 1,
      "title": "Best Electric Cars of 2026",
      "link": "https://example.com/best-evs",
      "snippet": "We tested every major EV...",
      "date": "Jan 10, 2026"
    }
  ],
  "stats": { "balance": 99994, "cost": 6, "cached": false }
}

stats.cost kredi cinsindendir (1 kredi = $0.0001). Taze bir çekme 6 kredidir ($0.0006); önbellek isabeti 3 kredidir ($0.0003). stats.cached size hangi yolu aldığınızı söyler.

5. Sayfalama

Her sayfa ayrı bir istektir — page değerini artırın. Yalnızca bir kullanıcı gerçekten ihtiyaç duyduğunda 2. ve sonraki sayfaları çekin. Bkz. 100 sonuç alma.

6. Hata yönetimi

  • 401 — hatalı/eksik API anahtarı.
  • 402 — kredi tükendi; yükleme yapın.
  • 429 — hız sınırı aşıldı (ücretsiz katman dakikada 60 istek = saniyede 1; kullandıkça öde dakikada 600 = saniyede 10, üst planlarda saniyede 60’a kadar); geri çekilin ve yeniden deneyin.
  • 5xx — geçici; üstel geri çekilme ile yeniden deneyin.

429/5xx için çağrıları her zaman geri çekilmeli bir yeniden denemeyle sarın.

7. Ucuz tutun

  1. Önbellek isabetleri yarı fiyatınadır — tekrarlanan sorgular için taze çekmeleri zorlamayın.
  2. Tembel sayfalama yapın.
  3. gl değerini hassas seçin ki yeniden çalıştırmalardan kaçının.

Sonraki adımlar

Frequently asked questions

Bir Google Search API'yi nasıl çağırırım?+

Sorgunuzla birlikte kimlik doğrulamalı bir POST isteği gönderin. serp.cheap ile: POST https://api.serp.cheap/v1/search, X-API-Key başlığı, şuna benzer bir JSON gövdesi: {"q": "...", "gl": "us"}. Yanıt, sonuçlardan oluşan bir organic[] dizisi içeren JSON'dur.

Bir Google Search API'yi tarayıcıdan çağırabilir miyim?+

Hayır — API anahtarınızı asla istemci tarafı kodda ifşa etmeyin. İstekleri her zaman kendi arka ucunuz üzerinden geçirin ki anahtar gizli kalsın.

Google Search API maliyetlerini nasıl düşük tutarım?+

Önbelleğe yaslanın (tekrarlanan sorgular serp.cheap'te yarı fiyatına sunulur), yalnızca gerektiğinde ek sayfalar çekin ve her çağrı için stats.cost değerini takip edin.

API anahtarını al

En ucuzu doğrudan, kart veya kripto ile öde, KYC yok. Ya da bir pazar yeri üzerinden.