API Reference

Bem-vindo à API da Plutyx. Acesse 50M+ contatos, verifique emails, enriqueça dados e automatize sua prospecção.

Base URL: https://plutyx.com

🔑 Autenticação

Todas as requisições requerem uma API Key no header X-API-Key.

curl https://plutyx.com/email-finder?domain=empresa.com&first_name=Joao \
  -H "X-API-Key: rmr_SUA_CHAVE_AQUI"

Obtenha sua chave em: Dashboard → Chaves de API

Email Finder

GET /email-finder

Encontra o email profissional de uma pessoa em um domínio específico.

Parâmetros

domainstringrequiredDomínio da empresa (ex: empresa.com.br)
first_namestringrequiredPrimeiro nome da pessoa
last_namestringoptionalSobrenome da pessoa

Exemplo

GET /email-finder?domain=empresa.com.br&first_name=Joao&last_name=Silva

Resposta

{
  "email": "joao.silva@empresa.com.br",
  "confidence": 87,
  "smtp_valid": true,
  "sources": ["website", "pattern_match"],
  "pattern": "{first}.{last}@{domain}"
}
GET /domain-search

Encontra todos os emails profissionais associados a um domínio.

Parâmetros

domainstringrequiredDomínio a pesquisar
limitintegeroptionalMáx. resultados (1-50, padrão: 10)

Resposta

{
  "domain": "empresa.com.br",
  "company": "Empresa Ltda",
  "emails": [
    {"email": "contato@empresa.com.br", "name": "Joao Silva", "position": "CEO"},
    {"email": "vendas@empresa.com.br", "name": "Maria Santos", "position": "Sales"}
  ],
  "pattern": "{first}@{domain}",
  "total": 8
}

Email Verifier

GET /verificar-email

Verifica a entregabilidade de um email via DNS + SMTP.

Parâmetros

emailstringrequiredEmail a verificar

Resposta

{
  "email": "joao@empresa.com.br",
  "verificado_smtp": true,
  "status": "deliverable",
  "codigo": 250,
  "mx_found": true
}

Bulk Operations

POST /verificar-emails-bulk

Verifica múltiplos emails de uma vez (máx. 100 por chamada).

Body (JSON)

{"emails": ["a@empresa.com", "b@empresa.com", ...]}

Resposta

{
  "results": [
    {"email": "a@empresa.com", "status": "deliverable"},
    {"email": "b@empresa.com", "status": "undeliverable"}
  ],
  "total": 2,
  "valid": 1
}

Gerar Leads

GET /gerar-leads

Gera leads B2B qualificados por nicho e localização. Nossa IA varre 15+ fontes simultaneamente.

Parâmetros

nichostringrequiredSegmento de mercado (ex: "Clínica Odontológica")
localizacaostringrequiredCidade/Estado (ex: "São Paulo, SP")
limiteintegeroptionalQtd. de leads (1-200, padrão: 20)
incluir_telefonesbooleanoptionalIncluir telefones (padrão: true)

Exemplo

GET /gerar-leads?nicho=advocacia&localizacao=Sao Paulo, SP&limite=50
X-API-Key: rmr_sua_chave

Resposta

{
  "leads": [
    {
      "nome": "Escritório Silva & Associados",
      "email": "contato@silvaadvogados.com.br",
      "telefone": "+55 11 9999-1234",
      "website": "silvaadvogados.com.br",
      "endereco": "Av. Paulista, 1000 - São Paulo, SP",
      "rating": 4.7,
      "confianca": 85,
      "tech_stack": ["WordPress", "Google Analytics"],
      "fonte": "google_maps"
    }
  ],
  "total": 50,
  "cache_hit": false
}

Maps Search

GET /maps-search

Busca empresas no Google Maps por categoria e localização.

Parâmetros

querystringrequiredCategoria ou nome de empresa
locationstringrequiredLocalização (cidade, estado)
limitintegeroptionalMáx. resultados (padrão: 20)

Crawler

GET /crawl

Rastreia um site e extrai emails, telefones, redes sociais e contatos.

Parâmetros

urlstringrequiredURL do site a rastrear
depthintegeroptionalProfundidade do crawl (1-3, padrão: 1)

Company Enrichment

GET /enrich-company

Enriquece dados de uma empresa: fundação, setor, tamanho, tech stack, redes sociais.

Parâmetros

domainstringrequiredDomínio da empresa

Intent Signals

GET /intent-signals

Detecta sinais de intenção de compra: vagas abertas, notícias recentes, financiamento, expansão.

Parâmetros

domainstringrequiredDomínio da empresa

Org Chart

GET /org-chart

Gera organograma da empresa com cargos e contatos dos decisores.

Parâmetros

domainstringrequiredDomínio da empresa

LinkedIn Finder

GET /linkedin-finder

Encontra o perfil LinkedIn de uma pessoa ou empresa.

Parâmetros

namestringrequiredNome da pessoa ou empresa
companystringoptionalNome da empresa (para refinar)

Listas

GET /lists

Lista todas as suas listas de leads.

POST /lists

Cria uma nova lista.

Body (JSON)

{"name": "Clínicas SP", "description": "Campanha novembro"}

Sequências de Email

GET /sequences

Lista todas as suas sequências de email.

GET /sequences/{id}/analytics

Retorna métricas de abertura e cliques da sequência.

Resposta

{
  "total_enrolled": 120,
  "opens": 48,
  "clicks": 12,
  "open_rate": 40.0,
  "click_rate": 10.0,
  "recent_events": [...]
}

Exportar para CRM

GET /export/hubspot

Exporta os últimos resultados no formato CSV de importação do HubSpot.

GET /export/pipedrive

Exporta no formato Pipedrive.

GET /export/salesforce

Exporta no formato Salesforce Leads.

Plutyx API v1.0 • Dashboard • Suporte: suporte@plutyx.com