Übersicht

Die Price Data API liefert Preis- und Angebotsdaten mehrerer Marktplatzquellen über eine einheitliche, asynchrone Job-Schnittstelle: Sie erstellen einen Job, fragen ihn ab und lesen die Ergebnisse – als JSON oder CSV. Basis-URL:

https://api-v2.pricepirate.com

Authentifizierung

Jede Anfrage trägt Ihren API-Schlüssel im Header:

x-api-key: <api-key>

Behandeln Sie den Schlüssel wie ein Passwort. Sie haben noch keinen Schlüssel? API-Schlüssel vergeben wir im Rahmen einer Enterprise-Anbindung – vereinbaren Sie ein Gespräch. Zum Ausprobieren ohne Enterprise-Anbindung: Die Idealo-Quelle gibt es auch als Selfservice – siehe Idealo API.

Das Job-Muster

Alle Quellen folgen demselben Ablauf:

Job erstellen – POST /api/jobs mit source, operation, country und Ihren queries. Die Antwort enthält eine Job-ID.
Job abfragen – GET /api/jobs/{jobId}, bis der Status completed oder failed ist.
Ergebnisse lesen – im Job selbst als JSON, oder als Export über GET /api/jobs/{jobId}/csv.

curl --request POST \
  --url https://api-v2.pricepirate.com/api/jobs \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{"source":"idealo","operation":"search-by-gtin","country":"de","queries":["4013474101469"]}'

curl --request GET \
  --url https://api-v2.pricepirate.com/api/jobs/<job_id> \
  --header 'x-api-key: <api-key>'

Ein Job nimmt viele queries auf einmal an; die Ergebnisse erscheinen fortlaufend, sobald einzelne Lookups fertig sind. Rufen Sie die Ergebnisse innerhalb etwa einer Stunde nach Abschluss ab.

Quellen und Operationen

Quelle	Operationen	Länder
`idealo`	`search-by-gtin`, `search-by-id`, `search-by-term`, `search-by-url`, `shop-info`	`de`, `at`, `es`, `fr`, `it`, `uk` (`shop-info`: nur `de`)
`klarna`	`search-by-gtin`	12 Länder, u. a. `de`, `us`, Skandinavien
`pricerunner`	`search-by-gtin`	`uk`, `se`, `dk`
`allegro`	`search-by-gtin`	`pl`
`toppreise`	`search-by-gtin`	`ch`

Weitere Marktplätze binden wir auf Anfrage an – sprechen Sie uns über die Enterprise-Anbindung an.

Referenz

Alle Endpunkte, Parameter und Antwortformate finden Sie unter Endpunkte in der Navigation.

Admin API

Price Data API

Hilfe

Produkt

Unternehmen

Authentifizierung

Das Job-Muster

Quellen und Operationen

Referenz

​Authentifizierung

​Das Job-Muster

​Quellen und Operationen

​Referenz

Authentifizierung

Das Job-Muster

Quellen und Operationen

Referenz