Buscar, guardar y exportar
Los filtros que comparten todas las búsquedas, las listas guardadas, las exportaciones CSV, los números de teléfono y el enriquecimiento, y lo que cuesta cada uno.
Filtros
Contar, buscar, desbloquear, las listas, las exportaciones y las campañas usan todos los mismos filtros. Las listas de palabras (referencia en inglés) dan los nombres exactos de sectores, países, palabras clave, tecnologías y cargos, con cuántas personas tiene cada uno.
| Filtro | Ejemplo | Cómo funciona |
|---|---|---|
q | software companies selling to restaurants | Palabras normales buscadas en el nombre, el cargo, la empresa y la descripción |
title | CFO, Finance Director | Una coma significa o. Reconoce abreviaturas. exclude_title deja fuera cargos |
seniority | C-Level,VP | Owner, Founder, Partner, C-Level, VP, Director (también coincide con Head of), Manager, Senior, Entry, Intern |
departments | Finance | |
industries | Software Development | Nombres exactos de la lista de sectores; una barra vertical significa o |
keywords | logistics, freight | Palabras que describen lo que hace la empresa: su nombre, etiquetas, sector y descripción. El filtro más amplio para nichos. keyword_scope=people mira en su lugar las habilidades de las propias personas, keyword_scope=any ambas cosas |
technologies | Shopify | Lo que usa la empresa |
employee_range | 11-50,51-200 | Tamaño de la empresa |
country, state, city | Germany o DACH | Nombres o regiones como Europe, DACH, Nordics |
company_domain, company_name | stripe.com | Una empresa |
has_phone, has_linkedin | true | Solo personas con número de teléfono o con perfil |
business_email_only | true | Solo personas cuyo correo está en el dominio propio de su empresa. Desactivado salvo que lo actives, así que las direcciones privadas solo quedan fuera si lo pides |
exclude_assistants | false | Activado por defecto. Una búsqueda por cargo deja fuera los cargos de asistente, como executive assistant o assistant to. Ponlo en false para mantenerlos |
Cada respuesta de recuento, búsqueda, lista y exportación indica qué se aplicó además de tus propios filtros. applied_filters muestra business_email_only cuando lo activaste, y applied_defaults muestra si se dejaron fuera cargos de asistente y cuáles. Una lista guardada almacena ambos, junto a la solicitud tal como la enviaste (filters.request).
Las regiones pueden solaparse. Egipto está tanto en Middle East como en Africa, México tanto en North America como en LATAM, y Turquía cuenta como Middle East, no como Europe. Una persona se cuenta una sola vez, aunque varias de las regiones que indiques incluyan su país. EMEA es Europa, Oriente Medio y África juntos.
Listas guardadas
Una lista guarda una búsqueda para que puedas exportarla o añadirla a una campaña más adelante.
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"}}'Una búsqueda guardada responde al momento. snapshot_total es el número de personas cuando el recuento termina a tiempo; si no, es null, con count_status en pending y una status_url. GET /api/v1/lists/{id}/fill muestra el estado, los recuentos, progress_percent y eta_seconds. Añade verbose=true para ver también la búsqueda guardada.
Envía record_ids en lugar de filters para quedarte exactamente con las personas que elegiste. GET /api/v1/lists muestra todas tus listas, GET /api/v1/lists/{id}/people recorre página a página las personas de una lista, POST /api/v1/lists/{id}/items añade más, PATCH cambia el nombre y DELETE elimina una lista. El list_id va directamente a POST /api/v1/campaigns/{id}/leads.
Exportaciones
Una exportación genera un CSV en 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}'Consulta status_url hasta que status sea done y luego descarga desde download_url. Cada correo se comprueba mientras se genera el archivo, y pagas 1 crédito por cada persona cuyo correo pasa la comprobación. Las personas que ya exportaste antes quedan fuera salvo que pongas "exclude_previously_exported": false, así que nunca pagas dos veces por la misma persona. Por encima de 50.000 filas, la exportación se convierte en un lote de archivos; consúltalo en GET /api/v1/export-batches/{batch_id}. POST /api/v1/lists/{id}/export exporta una lista guardada de la misma forma.
Números de teléfono
Añade "include_phones": true a una exportación, o pide números para hasta 100 personas con POST /api/v1/people/phones y sus record_ids. Un número de teléfono cuesta 10 créditos, solo cuando se devuelve uno, y los números que ya tienes son gratis. Los números de teléfono vienen con el plan Pro. GET /api/v1/people/phones/pricing muestra el precio y si tu plan los incluye.
Enriquece un registro
Cuando ya tienes un correo, o un nombre y un dominio de empresa, POST /api/v1/enrich completa los datos de la persona: 1 crédito por una coincidencia cuyo correo pasa la comprobación, nada si no hay coincidencia, y la misma persona otra vez es gratis. Un dominio de empresa solo devuelve gratis el perfil de la empresa.
Responder a las respuestas
Todas las respuestas de todas las campañas en una sola bandeja de entrada. Contesta en el mismo hilo, reenvía y marca las respuestas como interesado, reunión agendada o tu propia etapa del pipeline.
Campañas de principio a fin
Crea la campaña, escribe los correos, añade una lista, elige tus buzones y lanza. Cada paso es una llamada, y no se envía nada antes del lanzamiento.