← Powrót do bloga

Google Search API w Pythonie: pełny poradnik (2026)

Jak korzystać z Google Search API w Pythonie — uwierzytelnione zapytania, parsowanie wyników, paginacja, ponawianie i klasa klienta. Z przykładami.

1 min czytania

Ten poradnik pokazuje, jak odpytywać Google z poziomu Pythona i uzyskiwać czyste, ustrukturyzowane wyniki — przy użyciu serp.cheap, najtańszego Google Search API w 2026 roku.

Instalacja

pip install requests

Minimalny przykład

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

Klient wielokrotnego użytku z ponawianiem

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

Paginacja

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

Każda strona to osobne, płatne zapytanie — pobieraj je leniwie. Więcej w paginacji.

Kontrola kosztów

stats.cost jest podawany w kredytach (1 = $0.0001). Trafienia w cache kosztują 3 kredyty, świeże 6. Powtarzane zapytania są automatycznie obsługiwane z cache za połowę ceny.

Dalej

Frequently asked questions

Jaki jest najprostszy sposób na wywołanie Google Search API w Pythonie?+

Użyj biblioteki requests, aby wysłać POST z zapytaniem do SERP API. W serp.cheap: requests.post('https://api.serp.cheap/v1/search', headers={'X-API-Key': KEY}, json={'q': query, 'gl': 'us'}). Odpowiedź JSON zawiera listę organic[]. Wolisz typowanego klienta? Zainstaluj oficjalne SDK przez pip install serpcheap (dostępne są też integracje z Django i FastAPI).

Jak obsłużyć limity zapytań w Pythonie?+

Przechwyć HTTP 429 i ponów próbę z wykładniczym wycofaniem (np. przez urllib3 Retry lub tenacity). Limity serp.cheap to 60 zapytań/min (1 zap./s) na planie free, 600 zapytań/min (10 zap./s) w pay-as-you-go, a do 60 zap./s na najwyższych planach.

Pobierz klucz API

Najtaniej bezpośrednio, płać kartą lub kryptowalutą, bez KYC. Albo przez marketplace.