Este artículo describe la API de Búsqueda de Dominios de Snovio, el proceso general para utilizarla, qué solicitudes están disponibles, sus parámetros y respuestas.
Esta es la versión API de la herramienta Búsqueda de Dominios en la aplicación de Snov.io. Proporciona las mismas opciones de búsqueda a través de solicitudes API. Con la API, puedes solicitar y obtener información sobre empresas y sus contactos (correos electrónicos y perfiles de prospectos) basados en los dominios proporcionados.
Búsqueda de Dominios (solicitar información de la empresa)
Búsqueda de Dominios (obtener información de la empresa)
Obtener prospectos de un dominio
Buscar la dirección de correo electrónico de un prospecto
Obtener la dirección de correo electrónico de un prospecto
Buscar correos electrónicos por dominio
Obtener correos electrónicos de un dominio
A continuación, revisaremos los endpoints disponibles en la API de Búsqueda de Dominios, su propósito dentro del flujo de trabajo general y sus principales parámetros.c
Búsqueda de Dominio (solicitar información de la empresa)
Tipo de solicitud:POST
URL de la solicitud: https://api.snov.io/v2/domain-search/start/
Este es un endpoint base que envía una solicitud a la API de Snov.io para buscar información de una empresa utilizando un dominio proporcionado.
Parámetros de entrada:
En el campo domain de esta solicitud, ingresa el nombre del dominio (sitio web de la empresa) que deseas buscar.
La respuesta contiene dos elementos clave
- Un task_hash único que identifica tu solicitud. Lo usarás en la siguiente solicitud para obtener los resultados de la búsqueda.
- Una URL directa (en el campo result) para recuperar los resultados de la búsqueda (información de la empresa).
Búsqueda de Dominio (obtener información de la empresa)
Tipo de solicitud: GET
URL de la solicitud: https://api.snov.io/v2/domain-search/result/{task_hash}
Usa esta solicitud para recuperar los resultados de búsqueda generados por la solicitud anterior.
Parámetros de entrada:Esta solicitud no requiere ningún parámetro. Agrega el task_hash a la URL o usa el enlace directo proporcionado en la respuesta anterior.
La respuesta de esta solicitud contiene
- Detalles de la empresa (ubicación, sitio web, nombre, número de teléfono de la sede, industria, tamaño, etc.).
- Conteo de contactos por tipo (prospectos, correos electrónicos de dominio, contactos genéricos).
En el campo links de la respuesta, encontrarás URLs directas para buscar y filtrar contactos por tipo: prospectos, domain_emails, generic_contacts. Usa estas URLs para tus solicitudes posteriores.
Buscar prospectos por dominio
Tipo de solicitud: POST
URL de la solicitud: https://api.snov.io/v2/domain-search/prospects/start?domain=
Usa este endpoint para enviar una solicitud a la API de Snov.io y buscar perfiles de prospectos en el dominio proporcionado.
Parámetros de entrada:
En el campo domain, ingresa el nombre del dominio (sitio web de la empresa) que deseas buscar.
Usa el parámetro page para especificar qué página de resultados deseas buscar.
Paginación en los resultados de la API: Por defecto, cualquier solicitud sin el parámetro page busca automáticamente en la primera página de resultados.
Para buscar en otra página, especifica su número en los parámetros de la solicitud.
En el parámetro positions, enumera los títulos de trabajo por los que deseas filtrar, en un array (máximo 10). Ponlos entre corchetes, separados por comas.
Ejemplo: `positions[]: [Developer, Product Manager, Software Engineer]`
La respuesta contiene dos elementos clave:
- Un task_hash único que identifica tu solicitud. Lo usarás en la siguiente solicitud para obtener los resultados de la búsqueda.
- Una URL directa para la siguiente solicitud (en el campo result) para recuperar los resultados de la búsqueda.
Obtener prospectos de un dominio
Tipo de solicitud: GET
URL de la solicitud: https://api.snov.io/v2/domain-search/prospects/result/{task_hash}
Usa esta solicitud para recuperar los resultados de búsqueda de prospectos generados por la solicitud anterior.
Parámetros de entrada:Esta solicitud no requiere ningún parámetro. Agrega el task_hash a la URL o usa el enlace directo proporcionado en la respuesta anterior.
La respuesta de esta solicitud contiene:
La respuesta proporciona detalles sobre los prospectos encontrados en el dominio. Cada prospecto contiene los siguientes campos:
- "first_name"
- "last_name"
- "position"
- "source_page"
- "search_emails_start"
Paginación en los resultados de la API:
El campo total_count muestra el número total de prospectos para el dominio.
Si hay más páginas disponibles, verás un campo next con la URL para recuperar la siguiente página de resultados.
Importante:
Los correos electrónicos NO están incluidos en la respuesta de esta solicitud.
Para encontrar el correo electrónico de un prospecto, usa la URL proporcionada en el campo search_emails_start para ese prospecto.
El enlace incluye un prospect_hash único para cada prospecto. Cada prospecto se consulta con una solicitud separada.
Buscar la dirección de correo electrónico de un prospecto
Tipo de solicitud: POST
URL de la solicitud: https://api.snov.io/v2/domain-search/prospects/search-emails/start/{prospect_hash}
Usa esta solicitud para encontrar la dirección de correo electrónico de un prospecto (devuelta en los resultados de la solicitud anterior Obtener prospectos de un dominio).
Parámetros de entrada:
Esta solicitud no requiere parámetros adicionales. Un prospect_hash único se agrega automáticamente a la URL, usando el valor del campo search_emails_start en la respuesta anterior.
La respuesta contiene dos elementos clave:
- Un task_hash único que identifica tu solicitud. Lo usarás en la siguiente solicitud para obtener los resultados de la búsqueda.
- Una URL directa para la siguiente solicitud (en el campo result) para comprobar el estado de la búsqueda y recuperar la dirección de correo electrónico del prospecto.
Obtener el correo electrónico de un prospecto
Tipo de solicitud: GET
URL de la solicitud: https://api.snov.io/v2/domain-search/prospects/search-emails/result/{task_hash}
Usa esta solicitud para recuperar la dirección de correo electrónico del prospecto encontrado en la solicitud anterior.
Parámetros de entrada:
Esta solicitud no requiere parámetros adicionales. Un task_hash único se agrega automáticamente a la URL, usando el valor de la respuesta anterior.
Si la búsqueda aún está en curso, la respuesta mostrará in_progress. Una vez que la búsqueda esté completa y se encuentre la dirección de correo electrónico, se incluirá en la respuesta.
La respuesta de esta solicitud contiene:
Incluye la dirección de correo electrónico del prospecto y su estado de verificación, que puede ser válido (`verde`) o desconocido (`amarillo`). Lee más sobre los estados de correo.
Buscar correos electrónicos por dominio
Tipo de solicitud: POST
URL de la solicitud: https://api.snov.io/v2/domain-search/domain-emails/start?domain=
Utiliza este endpoint para enviar una solicitud a la API de Snov.io y buscar correos electrónicos de dominio en el dominio proporcionado.
Un correo electrónico de dominio es una dirección de correo electrónico no verificada que pertenece al dominio de una empresa. Puede ser el correo electrónico de un empleado o una dirección de correo electrónico genérica.
Parámetros de entrada:
En el campo domain de esta solicitud, ingresa el nombre del dominio (sitio web de la empresa) que deseas buscar.
La respuesta contiene dos elementos clave:
- Un task_has único que identifica tu solicitud. Lo utilizarás en la siguiente solicitud para obtener los resultados de la búsqueda.
- Una URL directa (en el campo result) para recuperar los resultados de la búsqueda.
Obtener correos electrónicos del dominio
Tipo de solicitud: GET
URL de la solicitud: https://api.snov.io/v2/domain-search/domain-emails/result/{task_hash}
Utiliza esta solicitud para recuperar los resultados de búsqueda de correos electrónicos generados por la solicitud anterior.
Parámetros de entrada: Esta solicitud no requiere parámetros adicionales. Agrega el "task_hash" al final de la URL o utiliza el enlace directo proporcionado en la respuesta anterior.
Si la búsqueda aún está en curso, la respuesta mostrará in_progress. Una vez que la búsqueda esté "completed", los correos electrónicos se incluirán en la respuesta.
La respuesta de esta solicitud contiene:
La respuesta proporciona una lista de direcciones de correo electrónico encontradas en el dominio.
Una solicitud proporciona hasta 50 correos electrónicos (una página de resultados). La primera página se devuelve por defecto.
El campo total_count en la respuesta muestra el número total de correos electrónicos disponibles. Si hay más páginas disponibles, recibirás la URL para recuperar la siguiente página de resultados en el campo next.
El campo next en la respuesta proporciona la URL que puedes utilizar para solicitar la siguiente página de resultados.
Buscar contactos genéricos por dominio
Tipo de solicitud: POST
URL de la solicitud: https://api.snov.io/v2/domain-search/generic-contacts/start
Utiliza este endpoint para enviar una solicitud a la API de Snov.io y buscar contactos genéricos en el dominio proporcionado.
Un contacto genérico es una dirección de correo electrónico no verificada del dominio de la empresa, a menudo correos técnicos o de servicio, como info@domain.com.
Parámetros de entrada:
En el campo "domain" de esta solicitud, ingresa el nombre del dominio (sitio web de la empresa) que deseas buscar.
La respuesta contiene dos elementos clave:
- Un task_hash único que identifica tu solicitud. Lo utilizarás en la siguiente solicitud para obtener los resultados de la búsqueda.
- Una URL directa (en el campo result) para recuperar los resultados de la búsqueda.
Obtener contactos genéricos del dominio
Tipo de solicitud: GET
URL de la solicitud: https://api.snov.io/v2/domain-search/generic-contacts/result/task_hash
Utiliza esta solicitud para recuperar los resultados generados por la solicitud anterior.
Parámetros de entrada: Esta solicitud no requiere parámetros adicionales. Agrega el task_hash al final de la URL o utiliza el enlace directo proporcionado en la respuesta anterior.
Si la búsqueda aún está en curso, la respuesta mostrará in_progress. Una vez que la búsqueda esté completed, los resultados se incluirán en la respuesta.
La respuesta de esta solicitud contiene:
La respuesta proporciona una lista de contactos de correo electrónico genéricos encontrados en el dominio.
Paginación en los resultados de la API:
Una solicitud proporciona hasta 50 contactos (una página de resultados). La primera página se devuelve por defecto.
El campo total_count en la respuesta muestra el número total de contactos disponibles. Si hay más páginas disponibles, recibirás la URL para recuperar la siguiente página de resultados en el campo next.
Costo de créditos de la API de Búsqueda de Dominios
Cada solicitud de tipo POST a la API de Búsqueda de Dominios deducirá un crédito de tu cuota de cuenta.
La solicitud no deducirá créditos en los siguientes casos
- La solicitud no proporciona ningún resultado (por ejemplo, no se encuentra información de la empresa, prospectos o correos electrónicos en la respuesta).
- La búsqueda no encuentra correos electrónicos verificados (verde o amarillo) para un prospecto. .
| URL de solicitud | Uso de créditos |
| https://api.snov.io/v2/domain-search | 1 crédito por cada solicitud de tipo “POST” |
| https://api.snov.io/v2/domain-search/prospects | 1 crédito por cada solicitud de tipo “POST” (hasta 20 perfiles de prospectos sin correos electrónicos por solicitud). |
| https://api.snov.io/v2/domain-search/domain-emails | 1 crédito por cada solicitud de tipo “POST” (hasta 50 correos electrónicos de dominio no verificados por solicitud). |
| https://api.snov.io/v2/domain-search/generic-contacts | 1 crédito por cada solicitud de tipo “POST” (hasta 50 contactos genéricos no verificados por solicitud). |
| https://api.snov.io/v2/domain-search/prospects/search-emails | 1 crédito por cada prospecto si se encuentra un correo electrónico válido (verde) o desconocido (amarillo). Si no se encuentran correos electrónicos verificados, no se cobran créditos. |
Consulta la información técnica completa en nuestra documentación de la API de Búsqueda de Dominios.
Lo lamentamos 😢
Cómo podemos mejorarlo?