Capzy Data API. Wybierz źródło.
Znajdź endpoint obsługiwanej strony, wyślij jego parametry i otrzymaj JSON. Przeglądaj dokumentację tutaj, a potem uruchamiaj i sprawdzaj żądania w playgroundzie w panelu.
Wyszukiwanie Amazon w skrócie
GET /v1/amazon/searchPrzykład poglądowy
Znajdź potrzebne źródło
Każde źródło ma własne endpointy, wymagane dane wejściowe i kształt odpowiedzi. Otwórz jego dokumentację, aby sprawdzić zakres, zanim zbudujesz integrację.
Wszystkie źródła (83)
Twoje pierwsze żądanie Data API
Ten przykład z Amazon używa endpointu GET specyficznego dla źródła. HTTP 200 zwraca dane źródła, a HTTP 202 zwraca status oczekiwania i jobId. Sprawdź oczekujące zadania na stronie Uruchomienia w panelu Data API, zanim wyślesz kolejne żądanie.
Utwórz klucz Data API
Otwórz panel Data API, aby skopiować dedykowany klucz Data API. Kredyty z planu są wykorzystywane w pierwszej kolejności, a dodatkowe użycie jest pobierane ze wspólnego salda konta Capzy.
Otwórz Data APIWybierz źródło i akcję
Skorzystaj z dokumentacji strony, aby znaleźć metodę, ścieżkę i wymagane parametry. Przykład wyszukiwania Amazon wysyła query i domain do /v1/amazon/search.
Przeczytaj parametry wyszukiwania AmazonSprawdź JSON w playgroundzie
Otwórz odpowiednie źródło w panelu, wybierz akcję, uzupełnij dane wejściowe i uruchom żądanie. Przed uruchomieniem sprawdź aktualną cenę endpointu.
Otwórz playground wyszukiwania Amazon
# Install: pip install requests
import os
import requests
response = requests.get(
"https://api.capzy.ai/v1/amazon/search",
headers={"X-API-Key": os.environ["CAPZY_DATA_API_KEY"]},
params={"query": "wireless earbuds", "domain": "com"},
timeout=120,
)
response.raise_for_status()
data = response.json()
if response.status_code == 202:
print("Pending:", data.get("status"), "Job:", data.get("jobId"))
print("Inspect this job in https://capzy.ai/dashboard/data-api/runs")
else:
for item in data.get("organic_results", []):
print(item["title"], item.get("price"))
print("Credits used:", response.headers.get("X-Credits-Used"))Poznaj kontrakt, zanim go wywołasz
Uwierzytelnianie jest wspólne dla wszystkich źródeł Data API. Metody, parametry i zwracane pola zależą od endpointu.
X-API-KeyWymagane · nagłówek- Wysyłaj w tym nagłówku dedykowany klucz Data API. Trzymaj go na serwerze, a w tych przykładach odczytuj go z CAPZY_DATA_API_KEY.
/v1/{source}/{path}Zależna od endpointu · ścieżka- Stosuj metodę i ścieżkę z dokumentacji źródła. Na przykład GET /v1/amazon/search przyjmuje query i domain jako parametry zapytania.
X-Credits-UsedNagłówek odpowiedzi- Sprawdź kredyty pobrane za żądanie. Ceny endpointów i rabaty planów są widoczne w panelu i dokumentacji źródła.
X-Next-CursorNagłówek odpowiedzi · jeśli występuje- Niektóre endpointy zwracają kursor do następnej strony. Używaj parametrów paginacji danego endpointu, bo nie każde źródło stosuje ten sam model paginacji.
Używaj rzeczywistych pól odpowiedzi źródła
Odpowiedź HTTP 200 wyszukiwania Amazon udostępnia organic_results na najwyższym poziomie. HTTP 202 zwraca zamiast tego kopertę statusu z jobId, sprawdź ją na stronie Uruchomienia w panelu. Ta skrócona udana odpowiedź zawiera poglądowe dane produktów.
{
"search_information": {
"query": "wireless earbuds"
},
"organic_results": [
{
"title": "Example wireless earbuds",
"price": "$27.99",
"extracted_price": 27.99,
"asin": "EXAMPLE001"
}
]
}Cennik
Plany Data API obejmują miesięczny limit kredytów. Dodatkowe użycie jest pobierane ze wspólnego salda konta Capzy. Aktualną cenę endpointu w kredytach sprawdź w dokumentacji źródła.
Ładowanie aktualnych cen…
Kilka rzeczy, które warto wiedzieć
Gdzie otwiera się playground?
W Panel → Data API → Scrapery. Linki do źródeł otwierają konfigurator danego źródła. Linki do endpointów wstępnie wybierają odpowiednią akcję, dzięki czemu przed uruchomieniem możesz sprawdzić wymagane dane wejściowe.
Czy mogę użyć klucza API solvera?
Użyj dedykowanego klucza Data API widocznego w panelu Data API. Data API ma własne ustawienia planu i kredyty w cenie, a dodatkowe użycie jest finansowane ze wspólnego salda konta Capzy.
Czy każde źródło zwraca ten sam JSON?
Nie. Każdy endpoint ma kształt odpowiedzi specyficzny dla źródła. Sprawdź jego udokumentowaną odpowiedź i obsłuż w aplikacji brakujące lub opcjonalne pola.
Co jeśli endpoint jest oznaczony jako wkrótce?
Panel oznacza endpointy, które nie są zweryfikowane lub dostępne do uruchomienia. Korzystaj z obsługiwanych akcji tam widocznych. Sam wpis w dokumentacji nie oznacza, że endpoint jest gotowy.
Znajdź źródło. Wypróbuj prawdziwe żądanie.
Playground w panelu łączy w jednym miejscu dane wejściowe, odpowiedź i aktualne ceny.
