InfluencerPact API

Schnellstart

Erstelle rechts einen Schlüssel und rufe damit einen beliebigen Endpunkt auf. Alle Antworten sind JSON.

curl https://api.influencerpact.com/v1/creators/lookup?platform=youtube\&handle=mkbhd \
  -H "Authorization: Bearer ip_live_…"

Authentifizierung

Sende deinen Schlüssel im Authorization-Header als Bearer-Token oder in X-API-Key. Schlüssel sind an dein Konto und deinen Tarif gebunden; wir speichern nur einen Hash, kopiere den Schlüssel also beim Erstellen.

Authorization: Bearer ip_live_…
# or
X-API-Key: ip_live_…

Ratenlimits

Limits gelten pro Schlüssel. Jede Antwort enthält X-RateLimit-Limit und X-RateLimit-Remaining (pro UTC-Tag); ein 429 enthält Retry-After.

Die Limits deines Tarifs gelten ebenfalls: Jede neue Suche verbraucht ein Such-Guthaben (erstattet, wenn nichts gefunden wird), Abfragen teilen sich dein stündliches Abfragebudget, Kampagnen folgen deinen Kampagnenlimits.

Endpunkte

• GET/v1/me

  Dein Tarif und die Limits für diesen Schlüssel.

• POST/v1/search

  Durchsucht die Creator-Datenbank mit denselben Filtern wie Discover. Liefert Follower, durchschnittliche Aufrufe, Engagement-Rate, Land, Sprache und ob eine E-Mail vorliegt.

  curl -X POST https://api.influencerpact.com/v1/search \
    -H "Authorization: Bearer $LUMI_KEY" -H "Content-Type: application/json" \
    -d '{ "platform": "youtube", "keyword": "skincare", "country": "US", "minFollowers": 10000, "page": 1 }'

• GET/v1/creators/lookup?platform=youtube&handle=mkbhd

  Ein Creator per Handle oder Profil-URL (url= statt handle= übergeben).

• POST/v1/creators/bulk

  Bis zum Sammellimit deines Tarifs an Handles oder Profil-URLs pro Anfrage. Jede Zeile ist entweder ein Creator oder der Grund, warum er nicht gefunden wurde.

  curl -X POST https://api.influencerpact.com/v1/creators/bulk \
    -H "Authorization: Bearer $LUMI_KEY" -H "Content-Type: application/json" \
    -d '{ "platform": "tiktok", "items": ["@khaby.lame", "https://www.tiktok.com/@zachking"] }'

• GET/v1/creators/authenticity?platform=youtube&handle=mkbhd

  Engagement-Echtheitssignale aus den aktuellen Beiträgen, mit Stichprobengröße und Methode. Zielgruppen-Demografie wird als nicht verfügbar gemeldet.

• POST/v1/reverse/emails

  Creator, deren öffentliche Bio diese E-Mails nennt oder die in deinen Kontakten stehen.

  curl -X POST https://api.influencerpact.com/v1/reverse/emails \
    -H "Authorization: Bearer $LUMI_KEY" -H "Content-Type: application/json" \
    -d '{ "emails": ["hello@creator.com"] }'

• GET/v1/campaigns

  Deine Kampagnen mit Summen (Aufrufe, Ausgaben, CPM, CPE, ROI).

• POST/v1/campaigns

  Kampagne anlegen, optional mit Beitragslinks.

  curl -X POST https://api.influencerpact.com/v1/campaigns \
    -H "Authorization: Bearer $LUMI_KEY" -H "Content-Type: application/json" \
    -d '{ "name": "Spring launch", "currency": "USD", "links": "https://youtu.be/dQw4w9WgXcQ" }'

• GET/v1/campaigns/{id}

  Eine Kampagne mit allen verfolgten Beiträgen und deren aktuellen Kennzahlen.

• POST/v1/campaigns/{id}/posts

  Beitragslinks (und optional Kosten pro Beitrag) zu einer Kampagne hinzufügen.

  curl -X POST https://api.influencerpact.com/v1/campaigns/{id}/posts \
    -H "Authorization: Bearer $LUMI_KEY" -H "Content-Type: application/json" \
    -d '{ "text": "https://www.tiktok.com/@user/video/7300000000000000000", "cost": 250 }'

• GET/v1/campaigns/{id}/history

  Stündliche Zeitreihe von Aufrufen, Likes, Kommentaren und Shares.

Die E-Mail-Rückwärtssuche akzeptiert bis zu 20 E-Mails pro Anfrage.

Antworten und Fehler

Erfolgreiche Antworten haben code 0 und die Nutzdaten in data. Fehler enthalten einen stabilen String-Code und eine lesbare message.

{ "code": 0, "message": "ok", "data": { … } }
{ "code": "API_RATE_MINUTE", "message": "Rate limit: 10 requests per minute", "data": null }

Ein null-Wert bedeutet, dass die Quelle ihn nicht veröffentlicht hat. Lücken füllen wir nie mit Schätzungen.