Keepa API: Kompleksowy przewodnik dla sprzedawców i deweloperów Amazon (2026)

## Spis treści

1. [Co to jest Keepa?](#co-to-jest-keepa)
2. [Co to jest Keepa API?](#co-to-jest-keepa-api)
3. [Koszty Keepa API](#koszty-keepa-api)
4. [Główne punkty końcowe API](#główne-punkty-końcowe-api)
5. [Rozpoczęcie pracy z Pythonem](#rozpoczęcie-pracy-z-pythonem)
6. [Praktyczne zastosowania](#praktyczne-zastosowania)
7. [Limity, tokeny i niuanse](#limity-tokeny-i-niuansy)
8. [Alternatywy dla Keepa API](#alternatywy-dla-keepa-api)
9. [Często zadawane pytania](#często-zadawane-pytania)

---

Jeśli sprzedajesz na Amazonie — lub tworzysz narzędzia dla osób, które to robią — prawdopodobnie słyszałeś o Keepa. Rozszerzenie przeglądarki, które pokazuje wykresy historii cen na stronach produktów Amazon, stało się domyślnym narzędziem badawczym dla milionów sprzedawców na całym świecie. Ale Keepa to coś więcej niż tylko rozszerzenie przeglądarki. Pod spodem kryje się potężne API, które śledzi ceny, ranking sprzedaży (BSR), oferty i dane kategorii na wszystkich głównych rynkach Amazon.

Ten przewodnik obejmuje wszystko, co musisz wiedzieć o Keepa API w 2026 roku: jakie są koszty, jakie punkty końcowe są dostępne, jak napisać swoją pierwszą integrację w Pythonie oraz gdzie API ma ograniczenia. Niezależnie od tego, czy jesteś sprzedawcą Amazon FBA automatyzującym swoje procesy badawcze, czy programistą tworzącym kolejne narzędzie do badania produktów, to jest Twój punkt startowy.

## Co to jest Keepa?

Keepa to usługa śledzenia cen Amazon założona w Niemczech. Monitoruje ceny produktów, ranking sprzedaży (BSR), liczbę ofert, liczbę recenzji i historię ocen na wszystkich głównych rynkach Amazon — w tym w USA, Wielkiej Brytanii, Niemczech, Francji, Włoszech, Hiszpanii i Japonii.

Większość sprzedawców Amazon po raz pierwszy spotyka Keepa poprzez jego rozszerzenie przeglądarki, które osadza interaktywne wykresy historii cen bezpośrednio na stronach produktów Amazon. Te wykresy pokazują, jak zmieniała się cena produktu, BSR i Buy Box w ciągu dni, tygodni, miesięcy lub lat.

Poza rozszerzeniem Keepa oferuje zestaw narzędzi dostępnych przez przeglądarkę:

- **Product Finder** — filtruj katalog Amazon według ceny, BSR, kategorii, liczby recenzji i dziesiątek innych kryteriów
- **Product Viewer** — zbiorczo importuj ASIN-y i pobieraj aktualne dane
- **Listy Best Sellerów** — śledź liderów kategorii w czasie rzeczywistym
- **Śledzenie i powiadomienia** — otrzymuj powiadomienia, gdy produkt osiągnie Twoją docelową cenę

Te narzędzia są przydatne same w sobie, ale prawdziwa moc dla sprzedawców i programistów nastawionych na automatyzację tkwi w **Keepa API**.

## Co to jest Keepa API?

Keepa API to interfejs HTTP typu REST, który udostępnia praktycznie wszystko, co Keepa śledzi na temat produktów Amazon. Zamiast ręcznie przeglądać stronę Keepa lub rozszerzenie, możesz programowo pobierać dane produktów, drzewa kategorii, profile sprzedawców, oferty i listy bestsellerów.

API zwraca odpowiedzi w formacie JSON i korzysta z systemu uwierzytelniania opartego na tokenach. Przekazujesz swój klucz dostępu API jako parametr zapytania, a Keepa odejmuje tokeny z Twojego salda w zależności od tego, jakie dane żądasz.

Kluczowe możliwości obejmują:

- **Dane produktów** — aktualna cena, BSR, liczba ofert, ocena, liczba recenzji, wymiary, waga oraz pełna historia cen/BSR sięgająca lat wstecz
- **Analiza Buy Box** — kto posiada Buy Box, jak długo i za jaką cenę
- **Śledzenie ofert** — aktualne oferty innych sprzedawców z cenami, stanem i informacjami o sprzedawcy
- **Przeglądanie kategorii** — pełne drzewo kategorii Amazon z identyfikatorami węzłów
- **Bestsellery** — najlepiej sprzedające się produkty w czasie rzeczywistym w danej kategorii
- **Wyszukiwanie sprzedawców** — szczegóły sprzedawcy, ASIN-y w sklepie i dane dotyczące zapasów
- **Wyszukiwanie produktów** — wyszukiwanie w katalogu Amazon na podstawie słów kluczowych
- **Oferty** — produkty z ostatnimi spadkami cen spełniające konfigurowalne kryteria
- **Śledzenie** — programowe powiadomienia o cenach z obsługą webhooków

Jeśli Amazon ma dane na ten temat, Keepa prawdopodobnie je śledzi — a API pozwala Ci uzyskać do nich dostęp na dużą skalę.

## Koszty Keepa API

Keepa korzysta z systemu cenowego opartego na tokenach. Każdy poziom subskrypcji API generuje określoną liczbę tokenów na minutę. Każdy token pozwala na żądanie danych dla jednego produktu, jednego sprzedawcy lub jednej kategorii. Nieużywane tokeny wygasają po 60 minutach.

### Wymaganie wstępne: Subskrypcja Keepa

Zanim będziesz mógł korzystać z API, musisz mieć podstawową subskrypcję Keepa:

- **Bezpłatna** — €0/miesiąc. Tylko rozszerzenie przeglądarki i podstawowe śledzenie. Brak dostępu do API.
- **Płatna** — €19/miesiąc (lub €189/rok). Odblokowuje Product Finder, Product Viewer, Best Sellers oraz podstawowy dostęp do API z 1 tokenem na minutę.

Plan za €19/miesiąc daje dostęp do API, ale przy 1 tokenie na minutę możesz zapytać tylko o około 60 produktów na godzinę — przydatne do testowania, ale nie do pracy produkcyjnej.

### Plany dodatkowe API

Do poważnego użytku należy wykupić plan API dodatkowo do podstawowej subskrypcji:

| Tokeny/Minutę | Koszt miesięczny | Produkty/godzinę (przybliż.) |
|---------------|------------------|------------------------------|
| 20 | €49 | ~1,200 |
| 60 | €129 | ~3,600 |
| 250 | €459 | ~15,000 |
| 500 | €879 | ~30,000 |
| 1,000 | €1,499 | ~60,000 |
| 2,000 | €2,499 | ~120,000 |
| 3,000 | €3,499 | ~180,000 |
| 4,000 | €4,499 | ~240,000 |

Kolumna „Produkty/godzinę” zakłada 1 token na żądanie produktu. W praktyce włączenie funkcji takich jak dane Buy Box (5 tokenów na żądanie) lub historia ofert proporcjonalnie zmniejsza przepustowość.

### Co kupuje token?

- **1 token** — standardowe zapytanie o produkt (historia cen, BSR, podstawowe metadane)
- **~2 tokeny** — zapytanie o produkt z danymi ofert
- **~5 tokenów** — zapytanie o produkt ze statystykami Buy Box
- **1 token** — wyszukiwanie kategorii lub lista bestsellerów
- **1 token** — profil sprzedawcy

Wszystkie plany są miesięczne, płatne z góry i można je anulować w dowolnym momencie. Możesz łączyć wiele planów na jednym koncie, a ulepszenia obowiązują natychmiast. Obniżenie poziomu jest ograniczone do raz na miesiąc.

## Główne punkty końcowe API

Keepa API udostępnia ponad 16 punktów końcowych. Oto te najbardziej istotne dla sprzedawców Amazon i twórców narzędzi:

### Żądanie produktu

Najczęściej używany punkt końcowy. Pobierz szczegółowe dane produktu dla maksymalnie 100 ASIN-ów na żądanie.

```
GET https://api.keepa.com/product?key=YOUR_KEY&domain=1&asin=B0088PUEPK
```

Zwraca: aktualną cenę (Amazon, rynek, używane), ranking sprzedaży, liczbę recenzji, ocenę, wymiary, wagę, kategorię oraz pełne tablice historii cen/BSR. Dodaj `&buybox=1` dla statystyk Buy Box (kosztuje 5 tokenów zamiast 1).

### Bestsellery

Pobierz najlepiej sprzedające się ASIN-y dla dowolnej kategorii Amazon.

```
GET https://api.keepa.com/bestsellers?key=YOUR_KEY&domain=3&category=340846031
```

Zwraca listę ASIN-ów posortowanych według aktualnego rankingu sprzedaży. Potrzebujesz identyfikatora węzła kategorii, który możesz znaleźć za pomocą punktu końcowego wyszukiwania kategorii.

### Wyszukiwanie i przeglądanie kategorii

Znajdź identyfikatory węzłów kategorii Amazon według słowa kluczowego lub przejdź przez drzewo kategorii.

```
GET https://api.keepa.com/search?key=YOUR_KEY&domain=3&type=category&term=kitchen
```

### Sprzedawca

Pobierz szczegóły sprzedawcy i opcjonalnie jego pełny sklep (wszystkie wymienione ASIN-y).

```
GET https://api.keepa.com/seller?key=YOUR_KEY&domain=1&seller=A2R2RITDJNW1Q6
```

### Product Finder

Odpowiednik narzędzia Product Finder Keepa w API. Filtruj katalog Amazon według dziesiątek kryteriów: zakres cen, zakres BSR, liczba recenzji, ocena, kategoria i więcej.

### Śledzenie

Programowo dodawaj produkty do listy śledzenia i konfiguruj powiadomienia. Obsługuje dostarczanie przez webhook — Keepa wysyła żądanie HTTP POST na Twój URL, gdy cena śledzonego produktu przekroczy Twój próg.

```
POST https://api.keepa.com/tracking?key=YOUR_KEY&type=add
```

### Oferty

Znajdź produkty z ostatnimi spadkami cen, zmianami BSR lub innymi kryteriami kwalifikującymi się do ofert. Przydatne dla sprzedawców arbitrażowych i hurtowych skanujących możliwości.

## Rozpoczęcie pracy z Pythonem

Najłatwiejszym sposobem interakcji z Keepa API z poziomu Pythona jest pakiet `keepa`, utrzymywany przez Alexa Kaszynskiego.

### Instalacja

```bash
pip install keepa
```

Wymaga Pythona 3.10+. Zależności obejmują `numpy`, `aiohttp` i `matplotlib`.

### Przykład 1: Zapytanie o pojedynczy produkt

```python
import keepa

api = keepa.Keepa("YOUR_API_KEY")

# Zapytanie o produkt na Amazon.de (domain=3)
products = api.query("B0088PUEPK", domain="DE")
product = products[0]

print(f"Tytuł: {product['title']}")
print(f"Ranking sprzedaży: {product['salesRankReference']}")
print(f"Ocena: {product['csv'][16][-1] / 10 if product['csv'][16] else 'N/A'}")
print(f"Liczba ofert: {product['csv'][11][-1] if product['csv'][11] else 'N/A'}")

# Historia cen znajduje się w tablicach product['csv']
# Indeks 0 = cena Amazon, 1 = Nowe na rynku, 2 = Używane, itd.
amazon_prices = product['csv'][0]  # [czas, cena, czas, cena, ...]
if amazon_prices is not None:
    latest_price = amazon_prices[-1] / 100  # Ceny w centach
    print(f"Aktualna cena Amazon: €{latest_price:.2f}")
```

### Przykład 2: Znajdź bestsellery w kategorii

```python
import keepa

api = keepa.Keepa("YOUR_API_KEY")

# Najpierw znajdź identyfikator kategorii dla „Kuchnia” na Amazon.de
categories = api.search_for_categories("kitchen", domain="DE")
for cat_id, cat_data in list(categories.items())[:3]:
    print(f"Kategoria: {cat_data['name']} (ID: {cat_id})")

# Pobierz bestsellery dla konkretnej kategorii
best_sellers = api.best_sellers_query(domain="DE", category="340846031")
print(f"\nTop 5 ASIN-ów w kategorii:")
for asin in best_sellers[:5]:
    print(f"  {asin}")

# Teraz zbiorczo zapytaj o te ASIN-y dla szczegółów
products = api.query(best_sellers[:5], domain="DE")
for p in products:
    print(f"  {p['asin']}: {p['title'][:60]}...")
```

### Przykład 3: Asynchroniczne zbiorcze zapytanie z limitem szybkości

Do obciążeń produkcyjnych zapytujących o tysiące produktów użyj asynchronicznego API:

```python
import asyncio
import keepa

async def analyze_asins(asin_list: list[str]):
    api = await keepa.AsyncKeepa().create("YOUR_API_KEY")

    # Biblioteka automatycznie zarządza limitem tokenów
    # Zapytania w partiach po 100 (maksymalnie na żądanie w Keepa)
    all_products = []
    for i in range(0, len(asin_list), 100):
        batch = asin_list[i:i+100]
        products = await api.query(batch, domain="DE")
        all_products.extend(products)
        print(f"Zapytano {len(all_products)}/{len(asin_list)} produktów")

    # Analizuj wyniki
    for p in all_products:
        title = p.get("title", "N/A")
        bsr = p.get("salesRankReference", -1)
        print(f"{p['asin']} | BSR: {bsr:>8} | {title[:50]}")

    return all_products

# Uruchom z listą ASIN-ów
asins = ["B0088PUEPK", "B07XJ8C8F5", "B09V3KXJPB"]
results = asyncio.run(analyze_asins(asins))
```

Biblioteka `keepa` w Pythonie automatycznie zarządza tokenami — wstrzymuje żądania, gdy saldo tokenów jest niskie, i wznawia je, gdy tokeny się regenerują.

## Praktyczne zastosowania

### Śledzenie BSR do badania produktów

Najczęstsze zastosowanie. Codziennie zapytuj o produkty i przechowuj historię BSR w swojej bazie danych. Wykresowanie BSR w czasie ujawnia sezonowość, trajektorie wprowadzenia na rynek i dynamikę konkurencji, której pojedynczy migawka nigdy nie pokaże. Sprzedawcy badający produkty do własnej marki używają tego do weryfikacji popytu przed podjęciem współpracy z dostawcą.

### Monitorowanie cen i zmiana cen

Śledź ceny konkurentów na różnych rynkach. Gdy konkurent obniży cenę, Twój system otrzymuje powiadomienie (poprzez webhooki lub polling) i może dostosować Twoje ceny za pomocą SP-API Amazon. Sprzedawcy hurtowi i arbitrażowi polegają na tym, aby utrzymać konkurencyjną pozycję.

### Analiza konkurencji

Użyj punktu końcowego Sprzedawca, aby monitorować sklep konkurenta. Śledź, ile ASIN-ów mają w ofercie, w jakie kategorie się rozwijają i jak zmienia się ich strategia cenowa w czasie. Połącz to z zapytaniami o produkty, aby zbudować pełny obraz konkurencji.

### Automatyczne skanowanie ofert

Punkt końcowy Oferty pokazuje produkty z ostatnimi spadkami cen lub poprawami BSR. Sprzedawcy arbitrażowi tworzą skrypty skanujące oferty spełniające określone kryteria — kategoria, zakres cen, próg ROI — i wysyłają powiadomienia na Slacka, Telegrama lub e-mail w ciągu minut od pojawienia się oferty.

### Analiza kategorii

Zapytaj o bestsellery w wielu kategoriach, aby zidentyfikować luki rynkowe. Porównaj średnie ceny, liczbę recenzji i rozkłady BSR w różnych kategoriach, aby znaleźć nisze, w których popyt jest wysoki, a konkurencja umiarkowana.

## Limity, tokeny i niuanse

### Wygaśnięcie tokenów

Tokeny wygasają 60 minut po wygenerowaniu, niezależnie od tego, czy zostały użyte, czy nie. Nie możesz gromadzić tokenów. Jeśli Twoja aplikacja działa w trybie impulsowym — na przykład wykonuje codzienne zadania wsadowe — płacisz za tokeny wygenerowane podczas 23 godzin, gdy system jest bezczynny. W przypadku obciążeń impulsowych rozważ kolejkowanie żądań i rozłożenie ich w oknie generowania tokenów.

### Dane Buy Box są drogie

Włączenie `buybox=True` w zapytaniu o produkt kosztuje 5 tokenów zamiast 1. Jeśli potrzebujesz danych Buy Box dla 10 000 produktów, to 50 000 tokenów — co przy planie 250 tokenów na minutę zajmuje ponad 3 godziny. Zaplanuj swoją linię danych odpowiednio.

### Format danych cenowych

Keepa przechowuje ceny w centach (liczby całkowite) i znaczniki czasu w „czasie Keepa” — minuty od 1 stycznia 2011 roku. Musisz przekonwertować oba na standardowe formaty. Biblioteka Pythona zajmuje się większością tego, ale jeśli używasz surowego HTTP API, pamiętaj o tych konwersjach:

```python
from datetime import datetime, timedelta

KEEPA_EPOCH = datetime(2011, 1, 1)

def keepa_time_to_datetime(keepa_minutes: int) -> datetime:
    return KEEPA_EPOCH + timedelta(minutes=keepa_minutes)

def keepa_price_to_float(price_cents: int) -> float:
    if price_cents < 0:
        return None  # -1 oznacza „niedostępne”
    return price_cents / 100
```

### Aktualność danych

Keepa nie skanuje każdego produktu ciągle. Popularne produkty (niski BSR) są aktualizowane częściej — czasami co godzinę. Produkty z długim ogonem mogą być aktualizowane tylko co kilka dni. Jeśli potrzebujesz gwarantowanej aktualności, możesz przekazać parametr `update` w swoim zapytaniu, aby wywołać żywe skanowanie, ale to kosztuje dodatkowe tokeny.

### Pokrycie rynków UE

Keepa obejmuje Amazon.de, .fr, .it, .es, .co.uk, .nl, .pl, .se i .be. Głębokość pokrycia jest różna — Niemcy i Wielka Brytania mają najwięcej danych historycznych, podczas gdy nowsze rynki, takie jak Szwecja i Belgia, mają krótsze historie. Dla sprzedawców skupionych na UE Keepa jest obecnie najlepszym pojedynczym źródłem danych cenowych obejmujących wiele rynków.

## Alternatywy dla Keepa API

Keepa jest liderem rynku w śledzeniu cen Amazon, ale nie jest jedyną opcją. Oto alternatywy warte rozważenia w zależności od Twoich potrzeb:

### Rainforest API

Szersze API danych Amazon, które obejmuje szczegóły produktów, wyniki wyszukiwania, recenzje i więcej. Rainforest skanuje Amazon bezpośrednio, zamiast utrzymywać własną bazę danych historycznych, więc daje migawki w czasie rzeczywistym, ale brakuje mu głębokiej historii cen, którą oferuje Keepa. Ceny zaczynają się od $75/miesiąc za 500 żądań.

### Pangolin API

Zaprojektowany jako bezpośredni konkurent Keepa z naciskiem na elastyczne ceny. Oferuje rozliczenia na żądanie zamiast planów tokenów na minutę, co może być bardziej opłacalne dla obciążeń impulsowych lub o niskim wolumenie. Pokrycie jest węższe niż Keepa.

### SP-API (Amazon Selling Partner API)

Własne API Amazon dla sprzedawców. Daje dostęp do własnych danych sprzedaży, zapasów, zamówień i informacji o katalogu. Nie zapewnia cen konkurencji ani historii BSR — możesz zobaczyć tylko dane związane z własnym kontem sprzedawcy. Bezpłatne w użyciu, ale skomplikowane w konfiguracji i ograniczone w zakresie.

### AgentXray

Jeśli jesteś sprzedawcą Amazon w UE, który chce uzyskać wglądy, jakie zapewniają dane Keepa, ale nie chce budować i utrzymywać własnej linii danych, [AgentXray](https://agentxray.ai) podchodzi do tego inaczej. Pobiera dane Keepa wraz z innymi źródłami i używa agentów AI do wykrywania możliwości produktowych, generowania raportów rynkowych i automatyzacji procesów badawczych — więc otrzymujesz analizę bez pisania kodu. Warto zbadać, jeśli Twoim celem są praktyczne informacje, a nie surowy dostęp do API.

### Budowanie własnego skanera

Niektórzy programiści pomijają API stron trzecich i budują własne skanery Amazon. Daje to maksymalną kontrolę i zerowe koszty API, ale Amazon aktywnie blokuje skanery, a utrzymanie ich to znaczna inwestycja inżynieryjna. Dla większości zespołów Keepa API jest bardziej opłacalne niż utrzymywanie infrastruktury skanowania.

## Często zadawane pytania

### Czy Keepa API jest darmowe?

Keepa API nie jest darmowe. Potrzebujesz co najmniej płatnej subskrypcji Keepa (€19/miesiąc), która daje podstawowy dostęp do API z 1 tokenem na minutę. Do praktycznego użytku dedykowane plany API zaczynają się od €49/miesiąc za 20 tokenów na minutę. Nie ma bezpłatnej wersji próbnej dla API.

### Ile produktów mogę zapytać dziennie za pomocą Keepa API?

Zależy od Twojego planu i opcji zapytania. Przy planie €49/miesiąc (20 tokenów/minutę) możesz zapytać o około 28 800 produktów dziennie przy standardowych żądaniach (1 token na każde). Plan €459/miesiąc (250 tokenów/minutę) pozwala na około 360 000 standardowych zapytań o produkty dziennie. Włączenie opcji takich jak dane Buy Box proporcjonalnie zmniejsza przepustowość.

### Czy Keepa API obsługuje wszystkie rynki Amazon?

Keepa obsługuje 13 rynków Amazon: USA, Wielka Brytania, Niemcy, Francja, Włochy, Hiszpania, Kanada, Japonia, Indie, Meksyk, Brazylia, Australia i Holandia. Dodatkowe rynki UE, w tym Polska, Szwecja i Belgia, są również objęte. Każdy rynek jest identyfikowany przez numeryczny identyfikator domeny w żądaniach API.

### Czy mogę używać Keepa API do projektów komercyjnych?

Tak. Warunki Keepa API pozwalają na użycie komercyjne. Wiele narzędzi SaaS, usług zmiany cen i platform do badania produktów jest zbudowanych na podstawie Keepa API. Powinieneś przejrzeć aktualne warunki usług Keepa pod kątem konkretnych ograniczeń dotyczących redystrybucji danych.

### Jaka jest różnica między Keepa API a biblioteką Python `keepa`?

Keepa API to interfejs HTTP REST udostępniany przez Keepa.com. Biblioteka `keepa` w Pythonie (do zainstalowania przez `pip install keepa`) to społecznościowo utrzymywany open-source'owy wrapper, który upraszcza interakcję z API z poziomu Pythona. Biblioteka automatycznie zajmuje się uwierzytelnianiem, limitami szybkości, parsowaniem danych i konwersją czasu Keepa. Nadal potrzebujesz klucza API Keepa, aby korzystać z biblioteki Pythona.

---

*Ten przewodnik jest oparty na dokumentacji i cenach Keepa API z początku 2026 roku. Keepa może aktualizować swoje poziomy cenowe lub specyfikacje punktów końcowych — zawsze sprawdzaj [keepa.com](https://keepa.com) pod kątem najnowszych informacji.*

## Powiązane lektury

- [keepa data explained](https://agentxray.ai/pl/blog/keepa-data-explained-eu-sellers)