API InfluencerPact

Mulai cepat

Buat kunci di sebelah kanan, lalu panggil endpoint apa pun dengannya. Semua respons berupa JSON.

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

Autentikasi

Kirim kunci di header Authorization sebagai bearer token, atau di X-API-Key. Kunci terikat ke akun dan paket Anda; kami hanya menyimpan hash-nya, jadi salin kunci saat membuatnya.

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

Batas laju

Batas berlaku per kunci. Setiap respons membawa X-RateLimit-Limit dan X-RateLimit-Remaining (per hari UTC); respons 429 menyertakan Retry-After.

Batas paket Anda juga berlaku: setiap pencarian baru memakai satu kredit pencarian (dikembalikan jika tidak ada hasil), pengecekan berbagi anggaran per jam Anda, dan kampanye mengikuti batas kampanye Anda.

Endpoint

• GET/v1/me

  Paket Anda dan batas yang berlaku untuk kunci ini.

• POST/v1/search

  Cari di database kreator dengan filter yang sama seperti Discover. Mengembalikan pengikut, rata-rata tayangan, tingkat interaksi, negara, bahasa, dan apakah ada email.

  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

  Satu kreator berdasarkan handle atau URL profil (gunakan url= sebagai ganti handle=).

• POST/v1/creators/bulk

  Hingga batas massal paket Anda untuk handle atau URL profil per permintaan. Setiap baris berisi kreator atau alasan tidak ditemukan.

  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

  Sinyal keaslian interaksi dari postingan terbaru kreator, dengan ukuran sampel dan metodenya. Demografi audiens dilaporkan tidak tersedia.

• POST/v1/reverse/emails

  Kreator yang bio publiknya mencantumkan email ini, atau yang ada di kontak Anda.

  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

  Kampanye Anda beserta totalnya (tayangan, pengeluaran, CPM, CPE, ROI).

• POST/v1/campaigns

  Buat kampanye, opsional dengan tautan postingan.

  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}

  Satu kampanye dengan semua postingan yang dilacak dan metrik terbarunya.

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

  Tambahkan tautan postingan (dan opsional biaya per postingan) ke kampanye.

  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

  Deret waktu per jam untuk tayangan, suka, komentar, dan bagikan.

Pencarian balik email menerima hingga 20 email per permintaan.

Respons dan galat

Respons sukses memiliki code 0 dan isi di data. Galat membawa code string yang tetap dan message yang mudah dibaca.

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

Metrik null berarti sumber tidak memublikasikannya. Kami tidak pernah mengisi celah dengan perkiraan.