← Bloga dön

Python'da Google Search API: Eksiksiz Eğitim (2026)

Python'da bir Google Search API nasıl kullanılır — kimlik doğrulamalı istekler, sonuç ayrıştırma, sayfalama, yeniden deneme ve yeniden kullanılabilir istemci sınıfı. Örneklerle.

1 dk okuma

Bu eğitim, Python’dan Google’da nasıl sorgulama yapacağınızı ve temiz, yapılandırılmış sonuçlar alacağınızı gösterir — 2026’nın en ucuz Google Search API’si olan serp.cheap kullanılarak.

Kurulum

pip install requests

Minimal örnek

import requests

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

Yeniden denemeli, yeniden kullanılabilir bir istemci

import requests
from requests.adapters import HTTPAdapter, Retry

class SerpClient:
    def __init__(self, api_key: str):
        self.s = requests.Session()
        self.s.headers.update({"X-API-Key": api_key})
        retries = Retry(total=4, backoff_factor=1.5,
                        status_forcelist=[429, 500, 502, 503, 504])
        self.s.mount("https://", HTTPAdapter(max_retries=retries))

    def search(self, q, gl="us", page=1, tbs=None):
        body = {"q": q, "gl": gl, "page": page}
        if tbs:
            body["tbs"] = tbs
        r = self.s.post("https://api.serp.cheap/v1/search", json=body, timeout=30)
        r.raise_for_status()
        return r.json()

client = SerpClient("YOUR_KEY")
data = client.search("python web scraping", gl="us")
print(data["stats"])  # balance, cost, cached

Sayfalama

def all_results(client, q, pages=3, gl="us"):
    out = []
    for p in range(1, pages + 1):
        out += client.search(q, gl=gl, page=p)["organic"]
    return out

Her sayfa ayrı bir ücretlendirilen istektir — tembel (lazy) şekilde çekin. Daha fazlası için sayfalama.

Maliyet kontrolü

stats.cost kredi cinsindendir (1 = $0.0001). Önbellek isabetleri 3 kredi, taze çekmeler 6 kredidir. Tekrarlanan sorgular otomatik olarak yarı fiyatına önbellekten sunulur.

Sıradaki

Frequently asked questions

Python'da bir Google Search API'yi çağırmanın en kolay yolu nedir?+

Sorgunuzu bir SERP API'ye POST etmek için requests kütüphanesini kullanın. serp.cheap ile: requests.post('https://api.serp.cheap/v1/search', headers={'X-API-Key': KEY}, json={'q': query, 'gl': 'us'}). Yanıt JSON'unda bir organic[] listesi bulunur. Tipli bir istemci mi tercih edersiniz? Resmi SDK'yı pip install serpcheap ile kurun (Django ve FastAPI entegrasyonları da mevcuttur).

Python'da hız limitlerini nasıl yönetirim?+

HTTP 429'u yakalayın ve üstel geri çekilme (exponential backoff) ile yeniden deneyin (ör. urllib3 Retry veya tenacity ile). serp.cheap'te ücretsiz katmanın limiti dakikada 60 istektir (saniyede 1); kullandıkça öde dakikada 600'e (saniyede 10) çıkar ve üst planlarda saniyede 60'a kadar yükselir.

API anahtarını al

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