Przejdź do treści

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

Źródło + akcjaGET /v1/amazon/search
Zapytaniewireless earbuds
Pole odpowiedziorganic_results · tytuły, ceny, ASIN-y

Przykł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.

  1. 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 API
  2. Wybierz ź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 Amazon
  3. Sprawdź 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
amazon_search.py
# 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.

response.example.json
{
  "search_information": {
    "query": "wireless earbuds"
  },
  "organic_results": [
    {
      "title": "Example wireless earbuds",
      "price": "$27.99",
      "extracted_price": 27.99,
      "asin": "EXAMPLE001"
    }
  ]
}

organic_results · tytuły, ceny, ASIN-y

Parametry

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.

Otwórz playground