# SERP API — szybki start: Twoje pierwsze wyszukiwanie w curl, Python i Node.js > Uruchom pierwsze wyszukiwanie przez SerpCrypto SERP API: zdobądź klucz API, wywołaj endpoint i odczytaj JSON. Bez KYC, płatność kryptowalutą. - URL: https://serpcrypto.com/pl/docs/ - Ostatnia aktualizacja: 2026-10-22 - Wydawca: SerpCrypto (https://serpcrypto.com) Jeden endpoint HTTPS, jeden klucz API, jeden kredyt za udane wyszukiwanie. Ta strona prowadzi Cię od pustego konta do sparsowanej strony wyników wyszukiwania Google, a potem wskazuje dokumentację do reszty. **Szybka odpowiedź — Jak wykonać pierwsze zapytanie do SERP API w SerpCrypto?** Kup pack kredytów, skopiuj klucz API z panelu i wyślij `GET https://serpcrypto.com/api/v1/search?q=your+query` z nagłówkiem `Authorization: Bearer YOUR_KEY`. **SerpCrypto** odpowiada stroną wyników jako JSON i pobiera 1 kredyt tylko wtedy, gdy wyszukiwanie się powiedzie. 10 000 wyszukiwań kosztują 7,50 USD, płatność kryptowalutą bez KYC, a kredyty nigdy nie wygasają. ## API w skrócie | Atrybut | Wartość | | --- | --- | | Bazowy URL | `https://serpcrypto.com/api/v1` | | Wyszukiwanie | `GET https://serpcrypto.com/api/v1/search` | | Kredyty | `GET https://serpcrypto.com/api/v1/credits` (za darmo) | | Uwierzytelnianie | Klucz API w nagłówku Authorization (Bearer) lub w parametrze zapytania api_key | | Silniki | Google Search, Google News, Google Images, Google Maps (wyniki lokalne), Google Shopping i Bing | | Rozliczenia | 1 kredyt = 1 udane zapytanie wyszukiwania, które zwraca jedną stronę wyników na dowolnym obsługiwanym silniku. Nieudane zapytanie nie jest rozliczane | | Wygasanie kredytów | Prepaid kredyty wyszukiwania nigdy nie wygasają: niewykorzystane wyszukiwania pozostają na Twoim koncie, dopóki ich nie wykorzystasz | | Format | JSON przez HTTPS, UTF-8 | ## Jak zdobyć klucz API? Cztery kroki. Bez dowodu, bez selfie, bez dokumentów i bez adresu e-mail, chyba że go chcesz. 1. **Załóż konto** — Logowanie numerem konta; email jest opcjonalny. Zapisz numer konta w menedżerze haseł: to Twój login. 2. **Zasil konto kryptowalutą** — Wyślij co najmniej 25 USD w BTC, USDT, USDC, ETH, SOL, LTC. Saldo zostanie uznane po potwierdzeniach sieci wymienionych na stronie płatności. 3. **Kup pack kredytów** — 10 000 wyszukiwań za 7,50 USD wystarczy, aby przetestować każdy engine. Większe packi obniżają stawkę do 0,30 USD/1K wyszukiwań. Zobacz cennik. 4. **Skopiuj klucz** — Twój klucz API pojawia się w panelu, gdy tylko kupisz pakiet kredytów z potwierdzonego salda kryptowalutowego. Trzymaj go w zmiennej środowiskowej o nazwie SERPCRYPTO_API_KEY, nigdy w repozytorium kodu. ## Jak wykonać pierwsze wyszukiwanie za pomocą curl? Wyeksportuj klucz raz, potem wyślij jedno zapytanie GET. Flaga `-G` z `--data-urlencode` buduje query string i sama koduje spacje i znaki diakrytyczne. Odpowiedź to pojedynczy dokument JSON, a `jq` utrzymuje ją czytelną w terminalu. Przykład pyta Google, domyślny engine, o wyniki w USA w języku angielskim. Zmień `q`, `gl` lub `hl` i uruchom ponownie: każde udane uruchomienie zużywa jeden kredyt. *curl + jq: pierwsze trzy wyniki organiczne* ```bash export SERPCRYPTO_API_KEY="paste-your-key-here" curl -sG "https://serpcrypto.com/api/v1/search" \ -H "Authorization: Bearer $SERPCRYPTO_API_KEY" \ --data-urlencode "q=best espresso grinder" \ -d gl=us -d hl=en | jq '.organic_results[:3]' ``` ## Jak wykonać to samo wyszukiwanie w Python? Użyj dowolnego klienta HTTP. W `requests` przekaż parametry jako słownik, a klucz API w nagłówku. `raise_for_status()` zamienia odpowiedź błędu, np. `401` dla nieprawidłowego klucza, na wyjątek, który możesz przechwycić. *Python 3.9+ z requests* ```python import os import requests API_URL = "https://serpcrypto.com/api/v1/search" API_KEY = os.environ["SERPCRYPTO_API_KEY"] response = requests.get( API_URL, params={"q": "best espresso grinder", "gl": "us", "hl": "en"}, headers={"Authorization": f"Bearer {API_KEY}"}, timeout=60, ) response.raise_for_status() data = response.json() print("credits used:", data["search_metadata"]["credits_used"]) for result in data.get("organic_results", [])[:3]: print(result["position"], result["title"], result["link"]) ``` ## A w Node.js? Node.js 18 i nowsze mają wbudowany `fetch`, więc żaden pakiet nie jest potrzebny. Zapisz plik z rozszerzeniem `.mjs`, aby użyć `await` na najwyższym poziomie, a następnie uruchom `node first-search.mjs`. *Node.js 18+ z wbudowanym fetch* ```javascript // first-search.mjs (Node.js 18 or later: fetch and top-level await are built in) const API_URL = "https://serpcrypto.com/api/v1/search"; const params = new URLSearchParams({ q: "best espresso grinder", gl: "us", hl: "en" }); const response = await fetch(`${API_URL}?${params}`, { headers: { Authorization: `Bearer ${process.env.SERPCRYPTO_API_KEY}` }, }); if (!response.ok) { throw new Error(`HTTP ${response.status}: ${await response.text()}`); } const data = await response.json(); console.log("credits used:", data.search_metadata.credits_used); for (const result of (data.organic_results ?? []).slice(0, 3)) { console.log(result.position, result.title, result.link); } ``` ## Jak sprawdzić, ile kredytów mi zostało? Wywołaj `GET https://serpcrypto.com/api/v1/credits` z tym samym kluczem. Jest bezpłatne i zwraca trzy liczby: pozostałe kredyty, kredyty wykorzystane dzisiaj oraz ile zapytań Twoje konto może wykonywać jednocześnie. Każde konto może wykonywać określoną liczbę wyszukiwań jednocześnie; limit jest widoczny w panelu i podwyższany na żądanie. *Odczytaj swoje kredyty* ```bash curl -s "https://serpcrypto.com/api/v1/credits" -H "Authorization: Bearer $SERPCRYPTO_API_KEY" ``` *Odpowiedź (przykładowe wartości)* ```json { "credits_remaining": 84210, "credits_used_today": 1290, "concurrency_limit": 10 } ``` ## Co zwraca wyszukiwanie? Każda odpowiedź ma ten sam szkielet na wszystkich silnikach. `search_metadata` mówi, czy wyszukiwanie się powiodło i ile kredytów zużyło. `search_parameters` powtarza zastosowane ustawienia, łącznie z domyślnymi. Następnie pojawia się jedna tablica lub obiekt na każdy blok strony wyników, taki jak `organic_results` lub `people_also_ask`. Blok jest obecny tylko wtedy, gdy strona go pokazuje, więc odczytuj go z wartością domyślną. Strona [format odpowiedzi](https://serpcrypto.com/pl/docs/response/) opisuje każdy blok i pole. *Struktura odpowiedzi Google (skrócone, przykładowe wartości)* ```json { "search_metadata": { "id": "srch_7f3a9c2e41b8", "status": "success", "engine": "google", "credits_used": 1 }, "search_parameters": { "engine": "google", "q": "best espresso grinder", "gl": "us", "hl": "en", "page": 1 }, "search_information": { "total_results": 18600000, "query_displayed": "best espresso grinder" }, "organic_results": [ { "position": 1, "title": "…", "link": "https://www.example.com/…", "snippet": "…" } ], "people_also_ask": [ { "question": "…", "snippet": "…", "link": "https://www.example.org/…" } ], "related_searches": [ { "query": "best espresso grinder under 300" } ], "pagination": { "current": 1, "next_page": 2 } } ``` ## Których parametrów używam najpierw? Pełna lista, z wartościami domyślnymi i dozwolonymi, jest w [dokumentacji API](https://serpcrypto.com/pl/docs/search/). | Parametr | Przykład | Co robi | | --- | --- | --- | | `q` | `best espresso grinder` | Zapytanie, tak jak wpisałby je człowiek. Wymagane. | | `engine` | `google_news` | Który silnik i vertical przeszukać. Domyślnie `google`. | | `gl` | `de` | Kraj wyników, dwie litery. Domyślnie `us`. | | `hl` | `de` | Język interfejsu. Domyślnie `en`. | | `location` | `Austin, Texas, United States` | Miejsce na poziomie miasta dla wyników lokalnych. | | `device` | `mobile` | Wyniki `desktop` (domyślnie) lub `mobile`. | | `page` | `2` | Strona wyników, od 1 do 10. Każda strona to jeden kredyt. | ## Ile kosztuje wyszukiwanie i kiedy jest bezpłatne? 1 kredyt = 1 udane zapytanie wyszukiwania, które zwraca jedną stronę wyników na dowolnym obsługiwanym silniku. Nieudane zapytanie nie jest rozliczane. Około 10 wyników organicznych na stronę, tak jak Google serwuje od czasu, gdy we wrześniu 2025 przestało respektować num=100; każda dodatkowa strona to jeden kredyt więcej. Zapytanie odrzucone z powodu złego parametru, błędnego klucza, pustego salda lub zajętego konta również jest bezpłatne, podobnie jak każde wywołanie endpointu kredytów. Ceny zaczynają się od 7,50 USD za 10 000 wyszukiwań do 0,30 USD/1K wyszukiwań przy największym pakiecie, według stanu na październik 2026. Prepaid kredyty wyszukiwania nigdy nie wygasają: niewykorzystane wyszukiwania pozostają na Twoim koncie, dopóki ich nie wykorzystasz. Strona [błędów](https://serpcrypto.com/pl/docs/errors/) wymienia każdy kod błędu i właściwy sposób ponowienia. ## Dokąd mam przejść dalej? - [Dokumentacja API: GET /search](https://serpcrypto.com/pl/docs/search/) — każdy parametr, wartość domyślna i błąd - [Format odpowiedzi](https://serpcrypto.com/pl/docs/response/) — każdy blok i pole JSON - [Lokalizacje i języki](https://serpcrypto.com/pl/docs/locations/) — gl, hl, location, device - [Błędy i ponowne próby](https://serpcrypto.com/pl/docs/errors/) — kody, przyczyny, backoff - [Python](https://serpcrypto.com/pl/docs/python/) — zapytania, httpx async, eksport CSV - [Node.js](https://serpcrypto.com/pl/docs/node/) — fetch, pula połączeń, paginacja - [curl i jq](https://serpcrypto.com/pl/docs/curl/) — przepisy w jednej linii - [Serwer MCP](https://serpcrypto.com/pl/docs/mcp/) — wyszukiwanie w internecie w Claude Desktop i Cursor - [LangChain i LlamaIndex](https://serpcrypto.com/pl/docs/langchain/) — narzędzie wyszukiwania dla agentów - [OpenAI function calling](https://serpcrypto.com/pl/docs/openai/) — schemat narzędzia i pętla wywołań ## Pytania z szybkiego startu ### Czy istnieje oficjalne SDK SerpCrypto? Nie. Dokumentacja zawiera kod do skopiowania dla Python, Node.js i curl, który wywołuje endpoint HTTPS bezpośrednio, więc nie ma pakietu do zainstalowania ani aktualizowania. Każdy język z klientem HTTP działa tak samo: jedno zapytanie GET, jeden nagłówek, jedna odpowiedź JSON. ### Czy mogę umieścić klucz API w adresie URL? Tak. `api_key=YOUR_KEY` działa jako parametr zapytania, co pomaga przy szybkim teście w przeglądarce. W kodzie lepiej użyj nagłówka `Authorization: Bearer`: adresy URL trafiają do logów, historii przeglądarki i udostępnianych zrzutów ekranu częściej niż nagłówki. ### Czy potrzebuję KYC lub karty kredytowej? Nie. SerpCrypto nie wymaga dowodu tożsamości, selfie, dokumentów ani karty. Logowanie numerem konta; email jest opcjonalny. Płacisz w BTC, USDT, USDC, ETH, SOL, LTC od minimalnego doładowania 25 USD. ### Jak przetestować przed zakupem dużego pakietu? Brak darmowego planu: testuj najmniejszym pakietem, opłaconym z minimalnej wpłaty; część dodana wyłącznie po to, by osiągnąć minimum, podlega zwrotowi na żądanie w ciągu 30 dni, w USDT lub USDC, jeśli jest niewykorzystana. Najmniejszy pakiet działa na tym samym endpoint i tych samych silnikach co największy, więc test z nim pokaże Ci, jak będzie wyglądać produkcja. --- SerpCrypto: SerpCrypto to API SERP dla deweloperów i agentów AI, które zwraca wyniki wyszukiwania Google i Bing w formacie JSON, z płatnością kryptowalutą i bez przesyłania dokumentów tożsamości. Przedpłacone kredyty wyszukiwania od 0,30 USD/1K wyszukiwań nigdy nie wygasają. Bez KYC — bez dokumentu, bez selfie, bez dokumentów. Płatność kryptowalutą.