Schnellstart

1. Zugangsdaten erhaltenAbschnittslink kopieren

Erstelle einen persönlichen API-Schlüssel unter Konto → Empfehlungen → API-Schlüssel. Kopiere ihn bei der Anzeige und stelle ihn deinem Skript als NINJABUY_API_KEY bereit. Halte ihn geheim.

Verwende für eine Anwendung, die für andere NinjaBuy-Kunden handelt, OAuth.

2. Links direkt erstellenAbschnittslink kopieren

curl -sS https://www.ninjabuy.com/api/v1/links \
  -H "Authorization: Bearer $NINJABUY_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"links":["https://weidian.com/item.html?itemID=7581746714"],"campaign":"spring-haul","label":"video 3"}'

Bis zu 100 Eingaben ergeben 200 mit results, warnings und request_id. Jedes Ergebnis enthält input und status; ein ok-Ergebnis enthält die zugeordnete url und den code. Prüfe jede Zeile: Ein HTTP-Erfolg bedeutet nicht, dass jede Eingabe umgewandelt wurde. Siehe Links.

3. Einen Stapel startenAbschnittslink kopieren

Mehr als 100 Eingaben werden automatisch im Hintergrund verarbeitet, bis zu 2.000 pro Anfrage. Um einen Auftrag mit einem Link auszuprobieren, setze async auf true:

curl -sS -D batch-headers.txt https://www.ninjabuy.com/api/v1/links \
  -H "Authorization: Bearer $NINJABUY_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"links":["https://www.ninjabuy.com/search?q=hoodie"],"async":true}'

Die Antwort lautet 202. Location gibt einen relativen Pfad wie /api/v1/jobs/JOB_ID an; Retry-After: 5 sagt, wann du den Status abfragen sollst. Der Antwortkörper enthält job.id, job.status, job.total und job.poll_after_seconds.

4. Ergebnisse per Cursor abrufenAbschnittslink kopieren

Verwende die Auftrags-ID aus dieser Antwort. Lass cursor bei der ersten Anfrage weg:

curl -sS "https://www.ninjabuy.com/api/v1/jobs/JOB_ID" \
  -H "Authorization: Bearer $NINJABUY_API_KEY"

Übergebe bei jeder weiteren Anfrage den zurückgegebenen Cursor unverändert, sofern er nicht null ist:

curl -sS "https://www.ninjabuy.com/api/v1/jobs/JOB_ID?cursor=RETURNED_CURSOR" \
  -H "Authorization: Bearer $NINJABUY_API_KEY"

Lies die results jeder Seite. Wenn has_more true ist, rufe die nächste Seite ab. Wenn es false ist, der Auftrag aber queued oder running ist, warte poll_after_seconds und frage mit dem gespeicherten Cursor erneut ab. Beende die Abfragen, wenn der Auftrag done oder failed ist und alle Seiten gelesen wurden. Siehe Aufträge und Fehler.

Nächste SchritteAbschnittslink kopieren

Wandle eine Google-Tabelle oder hochgeladene XLSX-/CSV-Datei mit Tabellen um oder finde Produkte mit der Suche.