Affiliate Hunter API

Ein Endpunkt: ihr schickt uns ein Produkt, ihr bekommt den Link zurück, den ihr in eurem Deal postet. Käufe über diesen Link werden euch zugeschrieben.

Bitte jetzt umstellen

Die API läuft ab sofort über affiliate-hunter.at und jeder Aufruf braucht euren API-Key. Aufrufe über flipfinder.at und ohne Key funktionieren noch für ein paar Wochen, verlasst euch aber nicht darauf — die alte Variante kann jederzeit abgeschaltet werden.

Endpunkt

POST https://affiliate-hunter.at/api/createDeal
Content-Type: application/json
Authorization: Bearer <euer-key>

Eure Kennung tag muss bei jedem Aufruf mitgeschickt werden — daran hängt die Zuordnung eurer Umsätze. Kennung und API-Key bekommt ihr von uns.

Der API-Key kommt in den Authorization-Header. Ein falscher Key wird abgelehnt.

Variante A — ASIN + Land

{ "asin": "B099NSDD9K", "region": "de", "tag": "<euer-tag>" }

Unterstützt wird nur Amazon Deutschland, region ist also immer de. Die ASIN hat 10 Zeichen, Großbuchstaben und Ziffern.

Variante B — Amazon-Link

{ "amzLink": "https://www.amazon.de/dp/B099NSDD9K", "tag": "<euer-tag>" }

ASIN und Land werden aus dem Link gelesen. Unterstützt werden /dp/, /gp/product/ und die mobile Form /gp/aw/d/. Kurzlinks der Domain amzn.eu funktionieren nicht — dort bitte Variante A verwenden.

Antwort

Status 200, der Body ist der fertige Link als reiner Text (kein JSON):

https://www.testbericht.de/dealz/B099NSDD9K?partnerID=<eure-partner-id>

Amazon Deutschland läuft bei uns über testbericht.de, die Abrechnung ist dieselbe.

Fehler

Status	Bedeutung
400	Linkformat nicht erkannt, ungültige Kennung oder ASIN, oder ein anderes Land als de
401	Falscher API-Key

Hinweis zur Nutzung

Den Link einmal erzeugen und speichern. Für ein Produkt ist der Link immer derselbe und bleibt dauerhaft gültig. Bitte nicht bei jedem Seitenaufruf neu anfragen.

Beispiel

curl -X POST https://affiliate-hunter.at/api/createDeal \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <euer-key>" \
  -d '{"asin":"B099NSDD9K","region":"de","tag":"<euer-tag>"}'