Jak używać Google Search API w 2026: pełny przewodnik

To praktyczny przewodnik od początku do końca po korzystaniu z Google Search API: uwierzytelnianie, wysyłanie zapytania, odczyt JSON, paginacja, obsługa błędów i utrzymanie niskich kosztów. Przykłady używają serp.cheap (najtańsza opcja w 2026 roku), ale koncepcje dotyczą każdego SERP API.

1. Uzyskaj klucz API

Najszybciej zaczniesz, rejestrując się bezpośrednio na app.serp.cheap/login — dostajesz 100 darmowych wyszukiwań, bez karty. Wolisz marketplace? Możesz też skorzystać z Apify lub RapidAPI. Niezależnie od ścieżki otrzymasz klucz, który przekazujesz w nagłówku X-API-Key. Kredyty są ważne przez 12 miesięcy.

2. Endpoint w jednej linii

POST https://api.serp.cheap/v1/search

Pełna dokumentacja: parametry Google Search API.

3. Twoje pierwsze żądanie

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

Przewodniki dla poszczególnych języków: Python · Node.js · PHP · Go · curl.

4. Odczytaj odpowiedź

{
  "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 jest podawany w kredytach (1 kredyt = $0.0001). Świeże pobranie to 6 kredytów ($0.0006); trafienie w cache to 3 ($0.0003). stats.cached mówi, którą ścieżkę otrzymałeś.

5. Paginacja

Każda strona to osobne żądanie — zwiększaj page. Pobieraj stronę 2+ tylko wtedy, gdy użytkownik faktycznie jej potrzebuje. Zobacz uzyskiwanie 100 wyników.

6. Obsługa błędów

• 401 — błędny/brakujący klucz API.
• 402 — brak kredytów; doładuj.
• 429 — przekroczony limit zapytań (free: 60 zap./min = 1 zap./s; pay-as-you-go: 600 zap./min = 10 zap./s; do 60 zap./s na najwyższych planach); wycofaj się i ponów.
• 5xx — przejściowy; ponów z wykładniczym wycofaniem.

Zawsze otaczaj wywołania ponawianiem z wycofaniem dla 429/5xx.

7. Utrzymuj niskie koszty

1. Trafienia w cache są o połowę tańsze — nie wymuszaj świeżych pobrań dla powtarzanych zapytań.
2. Paginuj leniwie.
3. Wybieraj gl precyzyjnie, aby uniknąć ponownych zapytań.

Kolejne kroki

• Zbuduj coś rzeczywistego: śledzenie pozycji w Pythonie lub Google Search dla agentów AI.

• Porównaj dostawców: najtańsze SERP API 2026.

• Uzyskaj klucz API na Apify →