ArgorantDocs

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.

FiltroExemploComo funciona
qsoftware companies selling to restaurantsPalavras comuns buscadas em nome, cargo, empresa e descrição
titleCFO, Finance DirectorUma vírgula significa "ou". Reconhece abreviações. exclude_title deixa cargos de fora
seniorityC-Level,VPOwner, Founder, Partner, C-Level, VP, Director (também corresponde a Head of), Manager, Senior, Entry, Intern
departmentsFinance
industriesSoftware DevelopmentNomes exatos da lista de setores; uma barra vertical significa "ou"
keywordslogistics, freightPalavras 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
technologiesShopifyO que a empresa usa
employee_range11-50,51-200Tamanho da empresa
country, state, cityGermany ou DACHNomes ou regiões como Europe, DACH, Nordics
company_domain, company_namestripe.comUma empresa
has_phone, has_linkedintrueSó pessoas com número de telefone ou perfil
business_email_onlytrueSó 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_assistantsfalseLigado 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.

Shell
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.

Shell
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.

Nesta página