Uma API de influenciadores para os seus dados de presentes.

Para que serve a API

É para quem cuida da operação ou para o desenvolvedor que quer os dados do Pozto em outro lugar: uma base no Airtable, um data warehouse, um dashboard, uma ferramenta interna. Ou o caminho inverso: adicionar creators a partir do sistema que despacha seus presentes, para ninguém digitar tudo duas vezes.

Ela trabalha com a sua própria lista, os creators para quem você já enviou produto. Não é um banco de influenciadores para buscar. Se é isso que você procura numa API de influenciadores, o Pozto não é a solução.

Chaves, URL base e limites

• URL base: https://pozto.co/api/v1
• Chaves: o dono da equipe cria as chaves em Configurações → API, no plano Brand. Uma chave começa com pz_ e aparece uma única vez: o Pozto guarda só uma impressão digital dela, então copie na hora. Dê a cada chave um nome que diga para que ela serve e revogue quando quiser. As Configurações mostram quando cada chave foi usada pela última vez.
• Como enviar: Authorization: Bearer pz_… em toda requisição.
• Escopo: uma chave lê e adiciona dados em todas as marcas da sua equipe.
• Limite de requisições: 120 requisições por minuto por chave.
• Páginas: GET /creators e GET /posts devolvem 100 por vez, ou até 500 com &limit=. Quando houver mais, a resposta traz um next_cursor: envie-o de volta como &cursor= para a próxima página. Na última página, ele é null.
• Formato: JSON na entrada e na saída. Os ids são strings e as datas seguem a ISO 8601.

Endpoints

O que vem em um creator e em um post

Um creator vem com nome, e-mail, contas (e se cada perfil foi encontrado), cupons de desconto, status e cada presente: o produto e o resto da caixa, a campanha, as datas de envio e de entrega, o prazo em dias, o código de rastreio, o cachê, os posts pedidos e os posts feitos até agora.

Um post é um vídeo, com cada plataforma em que ele foi publicado: link, legenda, data de publicação e se ele marcou você. Depois, o presente e o produto a que ele corresponde, e como o Pozto chegou a isso. Depois, a análise de vídeo: se o seu produto foi encontrado, cada momento na tela em segundos, cada vez que ele foi citado com a frase dita e um breve resumo. E a publicidade: clara, fraca ou nenhuma, com o motivo.

Adicionar creators e posts

POST /creators recebe brand_id e handles: @nomes, links de perfil ou links no estilo Linktree, até seis. Também aceita platform, name, email, codes, product (um id ou um nome; um nome novo adiciona o produto), shipped_at, delivered_at, due_days (21 se você não informar) e tracking. Um creator que já está na lista, reconhecido por qualquer uma das contas ou pelo e-mail, recebe o presente em vez de ser duplicado. A resposta é 201 para um creator novo e 200 para um existente, com o id do creator e o id do presente.

POST /posts recebe brand_id e url e, opcionalmente, creator_id e product_id. O post fica com o dono da conta, que entra na sua lista se for novo, e vai para a fila da análise de vídeo. A resposta diz se ele era novo, o perfil, a plataforma e se ele conta como um post sobre você.

# Creators atrasados, em uma marca
curl "https://pozto.co/api/v1/creators?brand_id=BRAND_ID&status=late" \
  -H "Authorization: Bearer pz_…"

# Adicionar um creator e o presente que você enviou
curl -X POST https://pozto.co/api/v1/creators \
  -H "Authorization: Bearer pz_…" \
  -H "Content-Type: application/json" \
  -d '{"brand_id":"BRAND_ID","handles":["@maya.glows"],"product":"Glow Serum","shipped_at":"2026-10-14"}'

# Posts desde 1º de outubro, dos mais novos aos mais antigos
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01" \
  -H "Authorization: Bearer pz_…"

# A próxima página: o next_cursor da resposta anterior
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01&cursor=NEXT_CURSOR" \
  -H "Authorization: Bearer pz_…"

Erros

Um erro volta como JSON com uma frase simples, como {"error": "…"}, e um status 4xx:

• 400: o corpo não é JSON, ou um campo não é válido, como uma data de entrega no futuro.
• 401: sem chave, ou com uma chave errada ou revogada.
• 403: sua equipe não está no plano Brand.
• 404: não há marca com esse brand_id na sua equipe.
• 409: a marca está bloqueada, porque seu plano tem menos marcas do que a sua equipe usa.
• 429: mais de 120 requisições em um minuto.

O que a API não faz

• Não busca influenciadores. Ela lê e adiciona dados à sua própria lista. A busca de creators é o Encontrar creators, dentro do app.
• Não traz visualizações, curtidas nem EMV nas respostas. Esses dados estão no app a partir do Starter e no relatório semanal. Veja relatórios de influenciadores.
• Sem webhooks. Para pegar posts novos, chame GET /posts com since.
• Sem edição nem exclusão. A API lê e adiciona. Alterações e remoções são feitas no app.
• Sem chaves por pessoa. As chaves são da equipe, e só o dono as cria.

O conteúdo dos posts é o mesmo do app: o Pozto encontra os posts analisando o vídeo, os frames, o áudio e a legenda, então os posts sem marcação também aparecem. Rastreamento de influenciadores explica como os posts são encontrados.

Preços

A API vem com o plano Brand: $999 por mês, ou $799 por mês no plano anual, com 10 marcas, 1.000 creators ativos, usuários ilimitados e login único (SSO). Todo o resto do Pozto começa em planos menores, e o plano gratuito cobre seus primeiros 10 creators. Ver planos.