API InfluencerPact

Início rápido

Crie uma chave à direita e chame qualquer endpoint com ela. Todas as respostas são JSON.

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

Autenticação

Envie a chave no cabeçalho Authorization como bearer token ou em X-API-Key. As chaves são ligadas à sua conta e plano; guardamos só um hash, então copie a chave ao criá-la.

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

Limites de taxa

Os limites valem por chave. Toda resposta traz X-RateLimit-Limit e X-RateLimit-Remaining (por dia UTC); um 429 traz Retry-After.

Os limites do seu plano também valem: cada nova busca usa um crédito de busca (devolvido se nada for encontrado), consultas compartilham seu orçamento por hora e campanhas seguem seus limites de campanha.

Endpoints

• GET/v1/me

  Seu plano e os limites desta chave.

• POST/v1/search

  Busca no banco de criadores com os mesmos filtros do Discover. Retorna seguidores, views médias, taxa de engajamento, país, idioma e se há e-mail.

  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

  Um criador por handle ou URL de perfil (use url= em vez de handle=).

• POST/v1/creators/bulk

  Até o limite em lote do seu plano de handles ou URLs por requisição. Cada linha é um criador ou o motivo de não ter sido encontrado.

  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

  Sinais de autenticidade do engajamento a partir dos posts recentes, com tamanho da amostra e método. A demografia da audiência é informada como indisponível.

• POST/v1/reverse/emails

  Criadores cuja bio pública mostra esses e-mails ou que estão nos seus contatos.

  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

  Suas campanhas com totais (views, gasto, CPM, CPE, ROI).

• POST/v1/campaigns

  Cria uma campanha, opcionalmente com links de posts.

  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}

  Uma campanha com todos os posts acompanhados e suas métricas mais recentes.

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

  Adiciona links de posts (e custo por post opcional) a uma campanha.

  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

  Série horária de views, curtidas, comentários e compartilhamentos.

A busca reversa por e-mail aceita até 20 e-mails por requisição.

Respostas e erros

Respostas de sucesso têm code 0 e o conteúdo em data. Erros trazem um code fixo em texto e uma message legível.

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

Uma métrica null significa que a fonte não a publicou. Nunca preenchemos lacunas com estimativas.