Encontrar, salvar e exportar
Os filtros que toda busca usa, listas salvas, exportações CSV, números de telefone e enriquecimento, e quanto cada um custa.
Filtros
Contagem, busca, revelação, listas, exportações e campanhas usam os mesmos filtros. As listas de termos (em inglês) trazem os nomes exatos de setores, países, palavras-chave, tecnologias e cargos, com quantas pessoas correspondem a cada um.
| Filtro | Exemplo | Como funciona |
|---|---|---|
q | software companies selling to restaurants | Palavras comuns buscadas em nome, cargo, empresa e descrição |
title | CFO, Finance Director | Uma vírgula significa "ou". Reconhece abreviações. exclude_title deixa cargos de fora |
seniority | C-Level,VP | Owner, Founder, Partner, C-Level, VP, Director (também corresponde a Head of), Manager, Senior, Entry, Intern |
departments | Finance | |
industries | Software Development | Nomes exatos da lista de setores; uma barra vertical significa "ou" |
keywords | logistics, freight | Palavras que descrevem o que a empresa faz: nome, tags, setor e descrição. O filtro mais amplo para nichos. keyword_scope=people busca nas habilidades das próprias pessoas, keyword_scope=any nos dois |
technologies | Shopify | O que a empresa usa |
employee_range | 11-50,51-200 | Tamanho da empresa |
country, state, city | Germany ou DACH | Nomes ou regiões como Europe, DACH, Nordics |
company_domain, company_name | stripe.com | Uma empresa |
has_phone, has_linkedin | true | Só pessoas com número de telefone ou perfil |
business_email_only | true | Só pessoas cujo e-mail está no domínio da própria empresa. Fica desligado se você não ativar, então endereços pessoais só ficam de fora quando você pede |
exclude_assistants | false | Ligado por padrão. Uma busca por cargo deixa de fora cargos de assistente, como executive assistant ou assistant to. Defina como false para mantê-los |
Toda resposta de contagem, busca, lista e exportação diz o que foi aplicado além dos seus próprios filtros. applied_filters mostra business_email_only quando você o ativou, e applied_defaults mostra se cargos de assistente ficaram de fora e quais. Uma lista salva guarda os dois, junto com a requisição como você a enviou (filters.request).
Regiões podem se sobrepor. O Egito está em Middle East e em Africa, o México está em North America e em LATAM, e a Turquia conta como Middle East, não como Europe. Uma pessoa é contada uma vez só, mesmo quando várias das regiões que você informa incluem o país dela. EMEA é Europe, Middle East e Africa juntos.
Listas salvas
Uma lista guarda uma busca para você exportá-la ou adicioná-la a uma campanha depois.
curl -X POST "https://app.argorant.com/api/v1/lists" -H "Authorization: Bearer $ARGORANT_API_KEY" \
-H "Idempotency-Key: uk-finance-list" -H "Content-Type: application/json" \
-d '{"name":"UK finance leaders","filters":{"title":"CFO, Finance Director","country":"United Kingdom"}}'Uma busca salva responde na hora. snapshot_total é o número de pessoas quando a contagem termina a tempo; caso contrário é null, com count_status pending e um status_url. GET /api/v1/lists/{id}/fill mostra o status, as contagens, progress_percent e eta_seconds. Adicione verbose=true para ver também a busca salva.
Envie record_ids em vez de filters para guardar exatamente as pessoas que você escolheu. GET /api/v1/lists mostra todas as suas listas, GET /api/v1/lists/{id}/people pagina as pessoas de uma lista, POST /api/v1/lists/{id}/items adiciona mais, PATCH renomeia e DELETE remove uma lista. O list_id vai direto em POST /api/v1/campaigns/{id}/leads.
Exportações
Uma exportação monta um CSV em segundo plano.
curl -X POST "https://app.argorant.com/api/v1/exports" -H "Authorization: Bearer $ARGORANT_API_KEY" \
-H "Idempotency-Key: uk-finance-export" -H "Content-Type: application/json" \
-d '{"filters":{"title":"CFO, Finance Director","country":"United Kingdom"},"limit":500}'Consulte status_url até status ser done e então baixe pelo download_url. Cada e-mail é verificado enquanto o arquivo é montado, e você paga 1 crédito por pessoa cujo e-mail passa na verificação. Pessoas que você já exportou antes ficam de fora, a menos que você defina "exclude_previously_exported": false, então você nunca paga duas vezes pela mesma pessoa. Acima de 50.000 linhas a exportação vira um lote de arquivos; acompanhe em GET /api/v1/export-batches/{batch_id}. POST /api/v1/lists/{id}/export exporta uma lista salva do mesmo jeito.
Números de telefone
Adicione "include_phones": true a uma exportação, ou peça números de até 100 pessoas com POST /api/v1/people/phones e os record_ids delas. Um número de telefone custa 10 créditos, só quando um número é retornado, e números que você já tem são grátis. Números de telefone estão disponíveis a partir do plano Pro. GET /api/v1/people/phones/pricing mostra o preço e se o seu plano inclui telefones.
Enriquecer um registro
Quando você já tem um e-mail, ou um nome e um domínio da empresa, POST /api/v1/enrich completa os dados da pessoa: 1 crédito por um resultado cujo e-mail passa na verificação, nada quando não há resultado, e a mesma pessoa de novo é grátis. Só um domínio da empresa retorna o perfil da empresa de graça.
Responder às respostas
Todas as respostas de todas as campanhas em uma caixa de entrada. Responda na mesma conversa, encaminhe e marque respostas como interessado, reunião agendada ou uma etapa do seu próprio funil.
Campanhas do início ao fim
Crie a campanha, escreva os e-mails, adicione uma lista, escolha as caixas de e-mail e inicie. Cada etapa é uma chamada, e nada é enviado antes do início.