API InfluencerPact

Bắt đầu nhanh

Tạo khóa ở bên phải rồi gọi bất kỳ endpoint nào. Mọi phản hồi đều là JSON.

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

Xác thực

Gửi khóa trong header Authorization dạng bearer token, hoặc trong X-API-Key. Khóa gắn với tài khoản và gói của bạn; chúng tôi chỉ lưu bản băm, nên hãy sao chép khóa khi tạo.

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

Giới hạn tốc độ

Giới hạn tính theo từng khóa. Mỗi phản hồi có X-RateLimit-Limit và X-RateLimit-Remaining (theo ngày UTC); phản hồi 429 có Retry-After.

Giới hạn của gói cũng áp dụng: mỗi truy vấn tìm kiếm mới dùng một lượt tìm kiếm (hoàn lại nếu không có kết quả), tra cứu dùng chung ngân sách theo giờ, chiến dịch theo giới hạn chiến dịch của bạn.

Endpoint

• GET/v1/me

  Gói của bạn và giới hạn áp dụng cho khóa này.

• POST/v1/search

  Tìm trong cơ sở dữ liệu nhà sáng tạo với cùng bộ lọc như Khám phá. Trả về người theo dõi, lượt xem TB, tỷ lệ tương tác, quốc gia, ngôn ngữ và có email hay không.

  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

  Một nhà sáng tạo theo handle hoặc URL hồ sơ (dùng url= thay cho handle=).

• POST/v1/creators/bulk

  Tối đa theo giới hạn hàng loạt của gói cho handle hoặc URL mỗi yêu cầu. Mỗi dòng là một nhà sáng tạo hoặc lý do không tìm thấy.

  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

  Tín hiệu độ thật của tương tác từ các bài gần đây, kèm cỡ mẫu và phương pháp. Nhân khẩu học khán giả được trả về là không có dữ liệu.

• POST/v1/reverse/emails

  Nhà sáng tạo có tiểu sử công khai ghi các email này, hoặc có trong danh bạ của bạn.

  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

  Các chiến dịch của bạn kèm tổng (lượt xem, chi tiêu, CPM, CPE, ROI).

• POST/v1/campaigns

  Tạo chiến dịch, có thể kèm liên kết bài đăng.

  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}

  Một chiến dịch cùng mọi bài đang theo dõi và chỉ số mới nhất.

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

  Thêm liên kết bài đăng (và chi phí mỗi bài, tùy chọn) vào chiến dịch.

  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

  Chuỗi thời gian theo giờ của lượt xem, thích, bình luận và chia sẻ.

Tra ngược email nhận tối đa 20 email mỗi yêu cầu.

Phản hồi và lỗi

Phản hồi thành công có code 0 và dữ liệu trong data. Lỗi có code dạng chuỗi cố định và message dễ đọc.

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

Chỉ số null nghĩa là nguồn không công khai. Chúng tôi không bao giờ lấp chỗ trống bằng ước tính.