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
| Parametre | Varsayılan | Açıklama |
|---|---|---|
q | zorunlu | Arama sorgusu |
gl | "us" | Ülke (ör. br, gb, de) |
hl | ülke varsayılanı | Arayüz dili geçersiz kılma |
page | 1 | Sonuç sayfası (1’den başlar) |
tbs | yok | Zaman 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
- Önbellek isabetleri yarı fiyatınadır — tekrarlanan sorgular için taze çekmeleri zorlamayın.
- Tembel sayfalama yapın.
gldeğerini hassas seçin ki yeniden çalıştırmalardan kaçının.
Sonraki adımlar
-
Gerçek bir şey oluşturun: bir Python sıralama takipçisi veya yapay zeka ajanları için Google Search.
-
Sağlayıcıları karşılaştırın: 2026’nın en ucuz SERP API’si.
-
Ücretsiz kaydolun ve API anahtarınızı alın → (kredi kartı gerekmez, 100 ücretsiz arama)