ArgorantDocs

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.

FiltroEjemploCómo funciona
qsoftware companies selling to restaurantsPalabras normales buscadas en el nombre, el cargo, la empresa y la descripción
titleCFO, Finance DirectorUna coma significa o. Reconoce abreviaturas. exclude_title deja fuera cargos
seniorityC-Level,VPOwner, Founder, Partner, C-Level, VP, Director (también coincide con Head of), Manager, Senior, Entry, Intern
departmentsFinance
industriesSoftware DevelopmentNombres exactos de la lista de sectores; una barra vertical significa o
keywordslogistics, freightPalabras 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
technologiesShopifyLo que usa la empresa
employee_range11-50,51-200Tamaño de la empresa
country, state, cityGermany o DACHNombres o regiones como Europe, DACH, Nordics
company_domain, company_namestripe.comUna empresa
has_phone, has_linkedintrueSolo personas con número de teléfono o con perfil
business_email_onlytrueSolo 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_assistantsfalseActivado 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.

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"}}'

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.

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}'

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.

En esta página