PICKLEAD
BlogPreçosEntrar
Voltar para a página inicial

API PARA DESENVOLVEDORES

Última atualização: 13 de agosto de 2026

A API do Picklead deixa você consumir seus leads por programação: a sua própria IA ou script busca e lista negócios locais em nome da sua conta. É um recurso do plano pago: a chave só é gerada por quem tem um passe ativo, e para de funcionar sozinha se o passe vencer.

Autenticação

Gere sua chave na aba API do painel. Ela aparece uma única vez na geração; guarde-a com cuidado (nós só armazenamos um hash, então não há como recuperá-la depois). Toda requisição leva a chave no cabeçalho:

Authorization: Bearer SUA_CHAVE

Você pode ter várias chaves (uma por script ou integração). Gerar uma nova não afeta as existentes; se uma vazar, revogue só ela na mesma tela.

Base URL

https://picklead.com.br/api/v1

POST /api/v1/leads — gerar leads

Busca negócios de um ou mais termos numa cidade e os importa para a sua conta. Cobra 1 crédito por lead novo importado (leads que você já tem não são cobrados de novo), igual à busca pela tela. Corpo em JSON:

  • termos: lista de termos. Cada item pode ser um texto ("dentista") ou um objeto { termo, nicho }.
  • cidade, estado, pais: onde buscar (padrão do país: Brasil).
  • max: teto de resultados por termo (padrão 20).

Resposta: os leads recém-inseridos, um resumo e o saldo restante.

GET /api/v1/leads — listar leads

Lista os leads já salvos na sua conta. Somente leitura, sem custo de crédito. Filtros opcionais na query string:

  • status: um ou mais status separados por vírgula.
  • nicho: filtra por nicho.
  • sem_site=true: só negócios sem site.
  • busca: procura no nome do negócio.

Limites de taxa

Até 10 chamadas por minuto por chave, além do limite geral de busca da conta (o mesmo da ferramenta). Passou do teto, a API responde 429; espere alguns segundos e tente de novo.

Erros

Toda falha volta em JSON, com um código HTTP e um campo erro:

  • 401: chave ausente, inválida, revogada ou sem passe ativo.
  • 400: entrada inválida ou sem crédito para a busca.
  • 429: muitas chamadas em pouco tempo.

Exemplos

Gerar leads de dentistas em Rio Branco:

curl -X POST https://picklead.com.br/api/v1/leads \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"termos":["dentista"],"cidade":"Rio Branco","estado":"AC","max":20}'

Listar os leads sem site já salvos:

curl "https://picklead.com.br/api/v1/leads?sem_site=true" \
  -H "Authorization: Bearer SUA_CHAVE"