Zum Inhalt springen

Capzy Data API. Deine Quelle wählen.

Finde einen Endpunkt einer unterstützten Website, sende seine Parameter und erhalte JSON. Lies hier die Referenz und führe Anfragen im Dashboard-Playground aus.

Amazon-Suche auf einen Blick

Quelle + AktionGET /v1/amazon/search
Abfragewireless earbuds
Antwortfeldorganic_results · Titel, Preise, ASINs

Beispieldaten

Finde die passende Quelle

Jede Quelle hat eigene Endpunkte, Pflichteingaben und eine eigene Antwortstruktur. Öffne ihre Referenz, um die Abdeckung zu prüfen, bevor du eine Integration baust.

Alle Quellen (83)

Deine erste Data-API-Anfrage

Dieses Amazon-Beispiel verwendet einen quellenspezifischen GET-Endpunkt. HTTP 200 liefert Quelldaten; HTTP 202 liefert einen ausstehenden Status und eine jobId. Prüfe ausstehende Jobs auf der Seite Läufe im Data API-Dashboard, bevor du eine weitere Anfrage sendest.

  1. Data API-Schlüssel erstellen

    Öffne das Data API-Dashboard, um deinen eigenen Data API-Schlüssel zu kopieren. Plan-Credits werden zuerst verbraucht; zusätzliche Nutzung wird deinem gemeinsamen Capzy-Kontoguthaben belastet.

    Data API öffnen
  2. Quelle und Aktion wählen

    Finde Methode, Pfad und Pflichtparameter in der Referenz der Website. Das Amazon-Suchbeispiel sendet query und domain an /v1/amazon/search.

    Parameter der Amazon-Suche lesen
  3. JSON im Playground prüfen

    Öffne die passende Quelle in deinem Dashboard, wähle die Aktion, fülle ihre Eingaben aus und führe eine Anfrage aus. Prüfe vorher den aktuellen Preis des Endpunkts.

    Playground der Amazon-Suche öffnen
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"))

Kenne die Schnittstelle vor dem Aufruf

Die Authentifizierung ist für alle Data API-Quellen gleich. Methoden, Parameter und Rückgabefelder gehören zum jeweiligen Endpunkt.

X-API-KeyErforderlich · Header
Sende deinen eigenen Data API-Schlüssel in diesem Header. Bewahre ihn auf dem Server auf und lies ihn in diesen Beispielen aus CAPZY_DATA_API_KEY.
/v1/{source}/{path}Endpunktspezifisch · Pfad
Halte dich an Methode und Pfad in der Quellreferenz. Zum Beispiel nimmt GET /v1/amazon/search query und domain als Query-Parameter.
X-Credits-UsedAntwort-Header
Zeigt die für die Anfrage berechneten Credits. Endpunktpreise und Planrabatte findest du im Dashboard und in der Quellreferenz.
X-Next-CursorAntwort-Header · falls vorhanden
Einige Endpunkte liefern einen Cursor für die nächste Seite. Verwende die Paginierungsparameter des jeweiligen Endpunkts; nicht jede Quelle nutzt dasselbe Paginierungsmodell.

Nutze die tatsächlichen Antwortfelder

Eine Amazon-Suchantwort mit HTTP 200 enthält organic_results auf oberster Ebene. HTTP 202 liefert stattdessen einen Status-Umschlag mit jobId; prüfe ihn auf der Seite Läufe im Dashboard. Diese gekürzte erfolgreiche Antwort verwendet beispielhafte Produktdaten.

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 · Titel, Preise, ASINs

Parameter

Preise

Data API-Pläne enthalten ein monatliches Credit-Kontingent. Zusätzliche Nutzung wird deinem gemeinsamen Capzy-Kontoguthaben belastet. Den aktuellen Credit-Preis eines Endpunkts findest du in der Quellreferenz.

Aktuelle Preise werden geladen…

Gut zu wissen

Wo öffnet sich der Playground?

Unter Dashboard → Data API → Scraper. Quell-Links öffnen den Builder dieser Quelle. Endpunkt-Links wählen die passende Aktion vor, sodass du die Pflichteingaben vor dem Ausführen prüfen kannst.

Kann ich meinen Solver-API-Schlüssel verwenden?

Verwende den eigenen Data API-Schlüssel aus dem Data API-Dashboard. Die Data API hat eigene Plansteuerung und inklusive Credits, während zusätzliche Nutzung über dein gemeinsames Capzy-Kontoguthaben finanziert wird.

Liefert jede Quelle dasselbe JSON?

Nein. Jeder Endpunkt hat eine quellenspezifische Antwortstruktur. Sieh dir die dokumentierte Antwort an und behandle fehlende oder optionale Felder in deiner Anwendung.

Was, wenn ein Endpunkt als demnächst markiert ist?

Das Dashboard markiert Endpunkte, die nicht verifiziert oder nicht ausführbar sind. Verwende die dort angezeigten unterstützten Aktionen; ein Referenzeintrag allein bedeutet nicht, dass ein Endpunkt bereit ist.

Quelle finden. Anfrage ausprobieren.

Der Playground zeigt Eingaben, Antworten und aktuelle Preise an einem Ort.

Playground öffnen