API de Snov.io

Las funciones de Snov.io se pueden utilizar a través de nuestra sencilla API REST. Integra con la API de Snov.io para sincronizar tus leads, encontrar emails, gestionar prospectos y más. La tasa de la API está limitada a 60 solicitudes por minuto.

Los usuarios de Snov.io con un plan gratuito pueden probar la funcionalidad de la API sin tener que actualizar poniéndose en contacto con nosotros en help@snov.io.

Autenticación

Es necesario generar un token de acceso para autenticar futuras solicitudes. Al realizar una solicitud, especifica este token de acceso en el campo Autorización.

Authorization: Bearer QSlHffXmCAILIOHNGXToq4LsP2yX64VQhEBZ7Ei4

Este es un ejemplo de generación de tokens.

Solicitud
POSThttps://api.snov.io/v1/oauth/access_token
Parámetros de entrada
grant_type
Siempre será
client_credentials
client_id
Tu identificación está disponible en la configuración de la cuentahttps://app.snov.io/account#/api
client_secret
Tu clave secreta está disponible en la configuración de la cuentahttps://app.snov.io/account#/api
Ejemplos de código
<?php
function getAccessToken()
{
    $params = [
        'grant_type'    => 'client_credentials',
        'client_id'     => 'c57a0459f6t141659ea75cccb393c5111',
        'client_secret' => '77cbf92b71553e85ce3bfd505214f40b'
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/oauth/access_token',
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);
    curl_close($ch);

    return $res['access_token'];

}
?>
def get_access_token():
params = {
    'grant_type':'client_credentials',
    'client_id':'c57a0459f6t141659ea75cccb393c111',
    'client_secret': '77cbf92b71553e85ce3bfd505214f40b'
}

res = requests.post('https://api.snov.io/v1/oauth/access_token', data=params)
resText = res.text.encode('ascii','ignore')

return json.loads(resText)['access_token']
Ejemplo de respuesta
{
"access_token":"3yUyQZdks0Ej7T2fXzjUWzwlTcO4dWisKkeMpESz",
"token_type":"Bearer",
"expires_in":3600
}
Parámetros de salida
access_token
Tu nuevo token de acceso
token_type
Siempre será Bearer
expires_in
Tiempo de expiración del token (en segundos)

Métodos API

POSTBúsqueda de dominio

1 crédito por cada solicitud única / 1 crédito por cada email del perfil de prospecto

Ingresa un nombre de dominio y Snov.io te devolverá información de la empresa, emails y perfiles de prospectos.

Costo de crédito
Solicitudes de información de la empresa, emails y perfiles de prospectos

1 crédito por cada solicitud POST. No se te cobrará si no obtienes resultados.

Emails del perfil de prospecto

1 crédito por cada perfil de prospecto con un email.

Domain search schema
Información de la empresa (solicitando resultados)
1 crédito por cada solicitud única.
POSThttps://api.snov.io/v2/domain-search/start
Parámetros de entrada
domain
El nombre de dominio para el cual deseas recibir información de la empresa. Por ejemplo, "snov.io".
Ejemplos de código
<?php
function companyInfoSearch()
{
    $token = getAccessToken();

    $params = [
        'domain' => 'snov.io',
    ];
    $headers = [
        'Authorization: Bearer ' . $token,
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v2/domain-search/start',
        CURLOPT_HTTPHEADER     => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $response = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $response;
}
?>
def company_info_search():
token = get_access_token()
headers = {'authorization': f'Bearer {token}'}
params = {
  'domain': 'snov.io',
}

res = requests.post('https://api.snov.io/v2/domain-search/start', params=params, headers=headers)

return json.loads(res.text)
Ejemplo de respuesta
{
  "data": [],
  "meta": {
    "domain": "snov.io",
    "task_hash": "6f15de14db954c761f8e7507547b3bd7"
  },
  "links": {
    "result": "https://api.snov.io/v2/domain-search/result/6f15de14db954c761f8e7507547b3bd7"
  }
}
Parámetros de salida
domain
Dominio para el cual estás obteniendo información de la empresa.
task_hash
ID único para la tarea de búsqueda que iniciaste. Se añade automáticamente a la URL de tu próxima solicitud para recibir los resultados.
result
URL de solicitud que debes utilizar para recibir la información de la empresa.
Información de la empresa (obteniendo resultados)
URL recibida de tu solicitud anterior.
GEThttps://api.snov.io/v2/domain-search/result/{task_hash}
Ejemplos de código
<?php
function companyInfoResult()
{
    $token = getAccessToken();

    $task_hash = 'b10e4c47693dbf87cc8de16edcc8ae22';
    $headers = [
        'Authorization: Bearer ' . $token,
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v2/domain-search/result/$task_hash',
        CURLOPT_HTTPHEADER     => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $response = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $response;
}
?>
def company_info_result():
token = get_access_token()
task_hash = '86586db9ac64ae5471eb18fc71b0dd5e'
headers = {'authorization': f'Bearer {token}'}

res = requests.get(f'https://api.snov.io/v2/domain-search/result/{task_hash}', headers=headers)

return json.loads(res.text)
Ejemplo de respuesta
{
  "data": {
    "company_name": "Snov.io",
    "city": "New York",
    "founded": "2017",
    "website": "snov.io",
    "hq_phone": "13477050819",
    "industry": "Computer Software",
    "size": "51-200",
    "related_domains": [
      "snov.me",
      "snov.com",
      "snov.nl",
      "snov.com.ua",
      "snov.cl"
    ]
  },
  "meta": {
    "domain": "snov.io",
    "task_hash": "6f15de14db954c761f8e7507547b3bd7",
    "prospects_count": 196,
    "emails_count": 108,
    "generic_contacts_count": 9
  },
  "links": {
    "prospects": "https://api.snov.io/v2/domain-search/prospects/start?domain=snov.io",
    "domain_emails": "https://api.snov.io/v2/domain-search/domain-emails/start?domain=snov.io",
    "generic_contacts": "https://api.snov.io/v2/domain-search/generic-contacts/start?domain=snov.io"
  },
  "status": "completed"
}
Parámetros de salida
company_name
El nombre de la empresa asociado con el dominio.
city
La ciudad en la que se encuentra la sede de la empresa.
founded
El año en que se fundó la empresa.
website
La dirección del sitio web de la empresa.
hq_phone
El número de teléfono de la sede de la empresa.
industry
Industria de la empresa.
size
El número de empleados que tiene la empresa.
related_domains
Dominios con el mismo SLD (dominio de segundo nivel) que el dominio para el que estás solicitando datos.
domain
El nombre de dominio para el cual la API ha proporcionado la información de la empresa.
task_hash
ID único para la tarea de búsqueda que iniciaste.
prospects_count
El número de perfiles de prospectos recuperados de tu solicitud.
emails_count
El número de emails de dominio recuperados de tu solicitud.
generic_contacts_count
El número de emails genéricos recuperados de tu solicitud.
prospects
URL para solicitar una lista con perfiles completos de prospectos.
domain_emails
URL para solicitar una lista con emails de dominio.
generic_contacts
URL para solicitar una lista con emails genéricos de la empresa.
status
Estado de la solicitud. Puede ser completado o en progreso.
Perfiles de prospectos (solicitando resultados)
1 crédito por cada solicitud única.
POSThttps://api.snov.io/v2/domain-search/prospects/start
Parámetros de entrada
domain
El nombre de dominio para el cual deseas encontrar perfiles de prospectos. Por ejemplo, "snov.io".
positions[]
Utiliza este parámetro para filtrar prospectos por puesto de trabajo, por ejemplo, "Desarrollador de Software". Para filtrar por múltiples puestos, ingresa un array con los puestos necesarios, separados por coma.

Puedes filtrar hasta 10 puestos por solicitud.
page
Número de página que contiene los perfiles de prospectos. Cada página muestra hasta 20 perfiles.

Si no se indica la página, por defecto se devolverá la primera página.
Ejemplos de código
<?php
function prospectsSearch()
{
    $token = getAccessToken();

    $params = [
        'domain'       => 'snov.io',
        'page'         => 1,
        'positions'    => ['Web developer','QA Engineer']
    ];

    $headers = [
        'Authorization: Bearer ' . $token,
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v2/domain-search/start',
        CURLOPT_HTTPHEADER     => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => http_build_query($params),
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $response = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $response;
}
?>
def prospects_search():
token = get_access_token()
headers = {'authorization': f'Bearer {token}'}
params = {
  'domain': 'snov.io',
  'page': 1,
  'positions[]': ['Web developer', 'QA Engineer']
}

res = requests.post('https://api.snov.io/v2/domain-search/prospects/start', params=params, headers=headers)

return json.loads(res.text)
Ejemplo de respuesta
{
  "data": [],
  "meta": {
    "domain": "snov.io",
    "tab": "prospects",
    "task_hash": "3384369c16aad810f58609a40ad65089",
    "page": 1,
    "positions": [
      "Web developer",
      "QA Engineer"
    ]
  },
  "links": {
    "result": "https://api.snov.io/v2/domain-search/prospects/result/3384369c16aad810f58609a40ad65089"
  }
}
Parámetros de salida
domain
Dominio para el cual estás obteniendo perfiles de prospectos.
tab
Muestra el tipo de resultados que estás solicitando.

prospectos indica que estás buscando perfiles de prospectos.

emails muestra emails de dominio.

servicio indica que estás obteniendo emails genéricos.
task_hash
ID único para la tarea de búsqueda que iniciaste. Se añade automáticamente a la URL de tu próxima solicitud para recibir los resultados.
page
Número de página que contiene los perfiles de prospectos. Cada página muestra hasta 20 perfiles.
positions
Puestos de trabajo utilizados para filtrar los resultados.
result
URL de solicitud que debes utilizar para recibir perfiles de prospectos.
Perfiles de prospectos (obteniendo resultados)
URL recibida de tu solicitud anterior.
GEThttps://api.snov.io/v2/domain-search/prospects/result/{task_hash}
Ejemplos de código
<?php
function prospectsResult()
{
    $token = getAccessToken();

    $task_hash = '3384369c16aad810f58609a40ad65089';
    $headers = [
        'Authorization: Bearer ' . $token,
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v2/domain-search/prospects/result/$task_hash',
        CURLOPT_HTTPHEADER     => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $response = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $response;
}
?>
def prospects_result():
token = get_access_token()
task_hash = '3384369c16aad810f58609a40ad65089'
headers = {'authorization': f'Bearer {token}'}

res = requests.get(f'https://api.snov.io/v2/domain-search/prospects/result/{task_hash}', headers=headers)

return json.loads(res.text)
Ejemplo de respuesta
{
  "data": [
    {
      "first_name": "John",
      "last_name": "Doe",
      "position": "Web developer",
      "source_page": "https://www.linkedin.com/in/john-doe/",
      "search_emails_start": "https://api.snov.io/v2/domain-search/prospects/search-emails/start/41627edbfff8ba9c0819a1aa51d232baf3fa1763e5813dc86e027ccbbefd7a16b0522391086776b8764c94d02bab1257df392"
    }
  ],
  "meta": {
    "domain": "snov.io",
    "tab": "prospects",
    "task_hash": "3384369c16aad810f58609a40ad65089",
    "page": 1,
    "positions": [
      "Web developer",
      "QA Engineer"
    ],
    "total_count": 18
  },
  "links": {
    "next": ""
  },
  "status": "completed"
}
Parámetros de salida
first_name
Nombre del prospecto.
last_name
Apellido del prospecto.
position
Puesto de trabajo del prospecto.
source_page
La página de origen de los datos personales recuperados.
search_emails_start
URL para tu próxima solicitud para buscar el email del prospecto.
domain
Dominio para el cual estás obteniendo perfiles de prospectos.
tab
Muestra el tipo de resultados que estás obteniendo.

prospectos indica que estás buscando perfiles de prospectos.

emails muestra emails de dominio.

servicio indica que estás obteniendo emails genéricos.
task_hash
ID único para la tarea de búsqueda que iniciaste.
page
Número de página que contiene los perfiles de prospectos. Cada página muestra hasta 20 perfiles.
positions
Puestos de trabajo utilizados para filtrar los resultados.
total_count
Número total de perfiles de prospectos encontrados.
next
URL para tu próxima solicitud para recuperar resultados de la siguiente página. Cada página tiene hasta 20 prospectos.
status
Estado de la solicitud. Puede ser completado o en progreso.
Email del prospecto (solicitando resultados)
URL recibida de tu solicitud anterior. Se te cobrará 1 crédito por cada prospecto con un email.
POSThttps://api.snov.io/v2/domain-search/prospects/search-emails/start/{prospect_hash}
Ejemplos de código
<?php
function searchProspectEmailsStart()
{
    $token = getAccessToken();

    $headers = [
        'Authorization: Bearer ' . $token,
    ];
    $task = '41627edbfff8ba9c0819a1aa51d232baf3fa1763e5813dc86e027ccbbefd7a16b0522391086776b8764c94d02bab1257df392';

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v2/domain-search/prospects/search-emails/start/$task',
        CURLOPT_HTTPHEADER     => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST           => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $response = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $response;
}
?>
def search_prospect_emails_start():
token = get_access_token()
headers = {'authorization': f'Bearer {token}'}

res = requests.post(f'https://api.snov.io/v2/domain-search/prospects/search-emails/start/'
  f'a811d72df2e52bd447621c4a1326e540102f3b70ba39a81bd597020ed0b9f812ee8de7e0f4ecad312716d03576fdf0af6d8277e1', headers=headers)

return json.loads(res.text)
Ejemplo de respuesta
{
  "data": [],
  "meta": {
    "task_hash": "5e846a1d80d95f66cfb30250a7c1881f"
  },
  "links": {
    "result": "https://api.snov.io/v2/domain-search/prospects/search-emails/result/5e846a1d80d95f66cfb30250a7c1881f"
  }
}
Parámetros de salida
task_hash
ID único para la tarea de búsqueda que iniciaste.
result
URL para tu próxima solicitud para obtener el email del prospecto.
Email del prospecto (obteniendo resultados)
URL recibida de tu solicitud anterior.
GEThttps://api.snov.io/v2/domain-search/prospects/search-emails/result/{task_hash}
Ejemplos de código
<?php
function searchProspectEmailsResult()
{
    $token = getAccessToken();

    $task_hash = '5e846a1d80d95f66cfb30250a7c1881f';
    $headers = [
        'Authorization: Bearer ' . $token,
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v2/domain-search/prospects/search-emails/result/$task_hash',
        CURLOPT_HTTPHEADER     => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $response = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $response;
}
?>
def search_prospect_emails_result():
token = get_access_token()
task_hash = '7f1df5bd8bca6f66e38dad0ffb30ba4c'
headers = {'authorization': f'Bearer {token}'}

res = requests.get(f'https://api.snov.io/v2/domain-search/prospects/search-emails/result/{task_hash}', headers=headers)

return json.loads(res.text)
Ejemplo de respuesta
{
  "data": {
    "searching_date": "2025-01-01 11:11:11",
    "emails": [
      {
        "email": "example@snov.io",
        "smtp_status": "valid"
      }
    ]
  },
  "meta": {
    "task_hash": "5e846a1d80d95f66cfb30250a7c1881f"
  },
  "links": [],
  "status": "completed"
}
Parámetros de salida
searching_date
Fecha en la que se realizó la búsqueda del email.
emails
Emails de prospectos.
smtp_status
Puede devolver válido, o desconocido (también conocido como no verificable). Puedes aprender más sobre los estados de los correos electrónicos aquí.
task_hash
ID único para la tarea de búsqueda que iniciaste.
status
Estado de la solicitud. Puede ser completado o en progreso.
Emails de dominio (solicitando resultados)
1 crédito por cada solicitud única.
POSThttps://api.snov.io/v2/domain-search/domain-emails/start
Parámetros de entrada
domain
Nombre de dominio de la empresa para el cual deseas encontrar emails de dominio. Por ejemplo, "snov.io".
Ejemplos de código
<?php
function domainEmailsSearch()
{
    $token = getAccessToken();

    $params = [
        'domain' => 'snov.io',
    ];
    $headers = [
        'Authorization: Bearer ' . $token,
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v2/domain-search/domain-emails/start',
        CURLOPT_HTTPHEADER     => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $response = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $response;
}
?>
def domain_emails_search():
token = get_access_token()
headers = {'authorization': f'Bearer {token}'}
params = {
  'domain': 'snov.io'
}

res = requests.post('https://api.snov.io/v2/domain-search/domain-emails/start', params=params, headers=headers)

return json.loads(res.text)
Ejemplo de respuesta
{
  "data": [],
  "meta": {
    "domain": "snov.io",
    "tab": "emails",
    "task_hash": "36fce9ac2667a827f6c5ab954e288bed",
    "next": ""
  },
  "links": {
    "result": "https://api.snov.io/v2/domain-search/domain-emails/result/36fce9ac2667a827f6c5ab954e288bed"
  }
}
Parámetros de salida
domain
Dominio para el cual estás obteniendo emails.
tab
Muestra el tipo de resultados que estás solicitando.

prospectos indica que estás buscando perfiles de prospectos.

emails muestra emails de dominio.

servicio indica que estás obteniendo emails genéricos.
task_hash
ID único para la tarea de búsqueda que iniciaste. Se añade automáticamente a la URL de tu próxima solicitud para recibir los resultados.
next
ID para la siguiente solicitud de página, si existe una. Si no hay más páginas disponibles, estará vacío.
result
URL de solicitud que debes utilizar para recibir emails de dominio.
Emails de dominio (obteniendo resultados)
URL recibida de tu solicitud anterior.
GEThttps://api.snov.io/v2/domain-search/domain-emails/result/{task_hash}
Ejemplos de código
<?php
function domainEmailsResult()
{
    $token = getAccessToken();

    $task_hash = '36fce9ac2667a827f6c5ab954e288bed';
    $headers = [
        'Authorization: Bearer ' . $token,
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v2/domain-search/domain-emails/result/$task_hash',
        CURLOPT_HTTPHEADER     => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $response = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $response;
}
?>
def domain_emails_result():
token = get_access_token()
task_hash = '36fce9ac2667a827f6c5ab954e288bed'
headers = {'authorization': f'Bearer {token}'}

res = requests.get(f'https://api.snov.io/v2/domain-search/domain-emails/result/{task_hash}', headers=headers)

return json.loads(res.text)
Ejemplo de respuesta
{
  "data": [
    {
      "email": "admin@snov.io"
    },
    {
      "email": "help@snov.io"
    }
  ],
  "meta": {
    "domain": "snov.io",
    "tab": "emails",
    "task_hash": "36fce9ac2667a827f6c5ab954e288bed",
    "next": "4ae6ca51c056c584db03c618dfe80dedb82ec37ab4667fa189386c82288a7422e8f4ab1010d84a13f2728d8f1b12b2ff139e3cb81108dc48",
    "total_count": 108
  },
  "links": {
    "next": "https://api.snov.io/v2/domain-search/domain-emails/start?domain=snov.io&next=4ae6ca51c056c584db03c618dfe80dedb82ec37ab4667fa189386c82288a7422e8f4ab1010d84a13f2728d8f1b12b2ff139e3cb81108dc48"
  },
  "status": "completed"
}
Parámetros de salida
email
Dirección de email del dominio.

Ten en cuenta que estos emails no están verificados. Para verificarlos, utiliza el método de Verificación de Emails.
domain
Dominio para el cual estás obteniendo emails.
tab
Muestra el tipo de resultados que estás obteniendo.

prospectos indica que estás buscando perfiles de prospectos.

emails muestra emails de dominio.

servicio indica que estás obteniendo emails genéricos.
task_hash
ID único para la tarea de búsqueda que iniciaste.
next
ID añadido a la URL de solicitud para acceder a la siguiente página de emails en caso de que exista.
total_count
Número total de emails de dominio encontrados.
next
URL de la solicitud para recuperar los resultados de la siguiente página en caso de que exista. Cada página tiene hasta 50 emails.
status
Estado de la solicitud. Puede ser completado o en progreso.
Contactos genéricos (solicitando resultados)
1 crédito por cada solicitud única.
POSThttps://api.snov.io/v2/domain-search/generic-contacts/start
Parámetros de entrada
domain
Nombre de dominio de la empresa para la cual deseas encontrar emails genéricos. Por ejemplo, "snov.io".
Ejemplos de código
<?php
function genericContactsSearch()
{
    $token = getAccessToken();

    $params = [
        'domain' => 'snov.io',
    ];
    $headers = [
        'Authorization: Bearer ' . $token,
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v2/domain-search/generic-contacts/start',
        CURLOPT_HTTPHEADER     => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $response = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $response;
}
?>
def generic_contacts_search():
token = get_access_token()
headers = {'authorization': f'Bearer {token}'}
params = {
  'domain': 'snov.io'
}

res = requests.post('https://api.snov.io/v2/domain-search/generic-contacts/start', params=params, headers=headers)

return json.loads(res.text)
Ejemplo de respuesta
{
  "data": [],
  "meta": {
    "domain": "snov.io",
    "tab": "service",
    "task_hash": "0e36e43b9b91a9b20d14b82c1ee141f2",
    "next": ""
  },
  "links": {
    "result": "https://api.snov.io/v2/domain-search/generic-contacts/result/0e36e43b9b91a9b20d14b82c1ee141f2"
  }
}
Parámetros de salida
domain
Dominio para el cual estás obteniendo emails genéricos.
tab
Muestra el tipo de resultados que estás solicitando.

prospectos indica que estás buscando perfiles de prospectos.

emails muestra emails de dominio.

servicio indica que estás obteniendo emails genéricos.
task_hash
ID único para la tarea de búsqueda que iniciaste. Se añade automáticamente a la URL de tu próxima solicitud para recibir los resultados.
next
ID para la siguiente solicitud de página, si existe una. Si no hay más páginas disponibles, estará vacío.
result
URL de solicitud que debes utilizar para recibir emails genéricos.
Contactos genéricos (obteniendo resultados)
URL recibida de tu solicitud anterior.
GEThttps://api.snov.io/v2/domain-search/generic-contacts/result/{task_hash}
Ejemplos de código
<?php
function genericContactsResult()
{
    $token = getAccessToken();

    $task_hash = '0e36e43b9b91a9b20d14b82c1ee141f2';
    $headers = [
        'Authorization: Bearer ' . $token,
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v2/domain-search/generic-contacts/result/$task_hash',
        CURLOPT_HTTPHEADER     => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $response = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $response;
}
?>
def generic_contacts_result():
token = get_access_token()
task_hash = '0e36e43b9b91a9b20d14b82c1ee141f2'
headers = {'authorization': f'Bearer {token}'}

res = requests.get(f'https://api.snov.io/v2/domain-search/generic-contacts/result/{task_hash}', headers=headers)

return json.loads(res.text)
Ejemplo de respuesta
{
  "data": [
    {
      "email": "orders@snov.io"
    },
    {
      "email": "sales@snov.io"
    }
  ],
  "meta": {
    "domain": "snov.io",
    "tab": "service",
    "task_hash": "0e36e43b9b91a9b20d14b82c1ee141f2",
    "next": "",
    "total_count": 9
  },
  "links": {
    "next": ""
  },
  "status": "completed"
}
Parámetros de salida
email
Dirección de email del contacto genérico.

Ten en cuenta que estos emails no están verificados. Para verificarlos, utiliza el método de Verificación de Emails.
domain
Dominio para el cual estás obteniendo emails genéricos.
tab
Muestra el tipo de resultados que estás obteniendo.

prospectos indica que estás buscando perfiles de prospectos.

emails muestra emails de dominio.

servicio indica que estás obteniendo emails genéricos.
task_hash
ID único para la tarea de búsqueda que iniciaste.
next
ID añadido a la URL de solicitud para acceder a la siguiente página de emails en caso de que exista.
total_count
Número total de emails genéricos encontrados para el dominio.
next
URL de la solicitud para recuperar los resultados de la siguiente página en caso de que exista. Cada página tiene hasta 50 emails.
status
Estado de la solicitud. Puede ser completado o en progreso.

POSTCuenta de email

Gratis

Con este método de la API, puedes averiguar el número de direcciones de email de un determinado dominio en nuestra base de datos. Es completamente gratuito, por lo que no necesitas créditos para utilizarlo.

Solicitud
POSThttps://api.snov.io/v1/get-domain-emails-count
Parámetros de entrada
domain
El nombre del dominio para el que deseas conocer el número de emails en nuestra base de datos.
Ejemplos de código
<?php
function getEmailCount()
{
    $token = getAccessToken();

    $params = [
        'access_token' => $token,
        'domain'       => 'octagon.com',
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/get-domain-emails-count',
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);
    curl_close($ch);

    return $res;

}
?>
def get_email_count():
token = get_access_token()
params = {'access_token':token,
        'domain':'octagon.com'

}

res = requests.post('https://api.snov.io/v1/get-domain-emails-count', data=params)

return json.loads(res.text)
Ejemplo de respuesta
{
"success":true,
"domain":"octagon.com",
"webmail":false,
"result":1369
}
Parámetros de salida
domain
El nombre del dominio para el que deseas conocer el número de emails en nuestra base de datos.
webmail
Es
true
si el dominio que buscas es webmail.
result
Número total de direcciones de emails que hemos encontrado para este dominio. No podemos proporcionar resultados para dominios de webmail, por lo que el resultado para webmail siempre será
0
.

POSTEmail Finder

Gratis

Este método de la API encuentra direcciones de correo electrónico utilizando el nombre y el apellido de la persona y un nombre de dominio. Si no tenemos esta dirección de correo electrónico en nuestra base de datos, no podremos proporcionarte los resultados inmediatamente. Para acelerar el proceso, puede utilizar el Añadir nombres para encontrar correos electrónicos método para impulsar esta dirección de correo electrónico para la búsqueda. Después de eso, intenta el método de búsqueda de correo electrónico de nuevo.

Límites: Si envías demasiadas peticiones en una hora puedes ver el siguiente mensaje de error: "Hay demasiados prospectos procesando. Por favor, inténtalo más tarde"
El límite de búsqueda en una hora depende de tu plan:

  • Starter - 200 solicitudes/hora
  • Pro 5K - 400 solicitudes/hora
  • Pro 20K - 600 solicitudes/hora
  • Pro 50K - 800 solicitudes/hora
  • Pro 100K - 1.000 solicitudes/hora
Solicitud
POSThttps://api.snov.io/v1/get-emails-from-names
Parámetros de entrada
firstName
El nombre del propietario de la dirección de correo electrónico.
lastName
El apellido del propietario de la dirección de correo electrónico.
domain
El nombre de dominio de la empresa que se utiliza en la dirección de correo electrónico.
Ejemplos de código
<?php
function getEmailFinder()
{
    $token = getAccessToken();

    $params = [
        'access_token' => $token,
        'domain'       => 'octagon.com',
        'firstName'    => 'gavin',
        'lastName'     => 'vanrooyen'
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/get-emails-from-names',
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);
    curl_close($ch);

    return $res;

}
?>
def get_email_finder():
token = get_access_token()
params = {'access_token':token,
          'domain':'octagon.com',
          'firstName': 'gavin',
          'lastName':'vanrooyen'
}

res = requests.post('https://api.snov.io/v1/get-emails-from-names', data=params)

return json.loads(res.text)
Ejemplo de respuesta
{
"success":true,
"params":{
"firstName":"gavin",
"lastName":"vanrooyen",
"domain":"octagon.com"
},
"data":{
"firstName":"gavin",
"lastName":"vanrooyen",
"emails":[
{
"email":"Gavin@octagon.com",
"emailStatus":"valid"
}
]
},
"status":{
"identifier":"complete",
"description":"Emails search is completed"
}
}
Parámetros de salida
status
Utiliza los valores de este objeto para detectar el estado del proceso.
identifier
Puede contener los siguientes valores:
complete
,
in_progress
, o
not_found
 . Si el identificador es
not_found
 la respuesta contendrá una matriz vacía de correos electrónicos.
description
Aquí verás una descripción de texto del estado de búsqueda del correo electrónico.
data
Contiene el resultado de la búsqueda.
firstName
El nombre del propietario de la dirección de correo electrónico.
lastName
Apellido del propietario de la dirección de correo electrónico.
emails
La matriz de direcciones de correo electrónico con sus estados. El valor
emailStatus
puede contener:
valid
o
unknown
.

POSTAñade nombres para encontrar emails

1 crédito por solicitud

Si Snov.io no tiene los correos electrónicos que buscas en su base de datos y no puede proporcionar estas direcciones de correo electrónico a través del Email Finder puede tratar de impulsar la solicitud de búsqueda de correo electrónico utilizando este método. Si se encuentra un correo electrónico, puedes recogerlo utilizando la aplicación gratuita Email Finder nueva solicitud.

Límites: Si envías demasiadas peticiones en una hora puedes ver el siguiente mensaje de error: "Hay demasiados prospectos procesando. Por favor, inténtalo más tarde"
El límite de búsqueda en una hora depende de tu plan:

  • Starter - 200 solicitudes/hora
  • Pro 5K - 400 solicitudes/hora
  • Pro 20K - 600 solicitudes/hora
  • Pro 50K - 800 solicitudes/hora
  • Pro 100K - 1.000 solicitudes/hora
Solicitud
POSThttps://api.snov.io/v1/add-names-to-find-emails
Parámetros de entrada
firstName
El nombre del propietario de la dirección de correo electrónico.
lastName
El apellido del propietario de la dirección de correo electrónico.
domain
El nombre de dominio de la empresa que se utiliza en la dirección de correo electrónico.
Ejemplos de código
<?php
function getAddNamesToFindEmails()
{
    $token = getAccessToken();

    $params = [
        'access_token' => $token,
        'domain'       => 'octagon.com',
        'firstName'    => 'gavin',
        'lastName'     => 'vanrooyen'
    ];


    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/add-names-to-find-emails',
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);
    curl_close($ch);

    return $res;

}
?>
def add_names_to_find_emails():
token = get_access_token()
params = {'access_token':token,
          'domain':'octagon.com',
          'firstName': 'gavin',
          'lastName':'vanrooyen'
}

res = requests.post('https://api.snov.io/v1/add-names-to-find-emails', data=params)

return json.loads(res.text)
Ejemplo de respuesta
{
"success":true,
"firstName":"gavin",
"lastName":"vanrooyen",
"domain":"octagon.com",
"userId":666871,
"sent":true
}

Si la solicitud de correo electrónico se ha añadido con éxito a la cola, el método devuelve "sent":true.

POSTAñadir URL a la búsqueda de prospectos

1 crédito por solicitud

Encuentra prospectos por URL social. Para recibir los resultados, utiliza el botón Obtén el prospecto con el método de URL.

Solicitud
POSThttps://api.snov.io/v1/add-url-for-search
Parámetros de entrada
url
Un enlace al perfil de redes sociales del prospecto. Especifica el nombre de la red social entre [corchetes] (LinkedIn o X).
Ejemplos de código
<?php
function addUrlForSearch()
{
    $token = getAccessToken();

    $params = [
        'access_token' => $token,
        'url'          => 'https://www.linkedin.com/in/johndoe/&social'
    ];


    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/add-url-for-search',
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);
    curl_close($ch);

    return $res;

}
?>
def add_url_for_search():
token = get_access_token()
params = {'access_token':token,
          'url':'https://www.linkedin.com/in/elie-ohayon-aaab7341'
}

res = requests.post('https://api.snov.io/v1/add-url-for-search', data=params)

return json.loads(res.text)
Ejemplo de respuesta
{
  "success": true
}
Parámetros de salida
success
Es
true
si el prospecto se ha añadido con éxito a la lista de búsqueda.
message
Ha habido un error al añadir el prospecto a la lista.

POSTObtén un prospecto con URL

Gratis

Proporcionar la URL social del prospecto y Snov.io devolverá la información completa sobre el prospecto con las direcciones de correo electrónico encontradas. Previamente debes utilizar el Añade la URL para buscar el método de prospección. De lo contrario, el resultado no se mostrará.

Solicitud
POSThttps://api.snov.io/v1/get-emails-from-url
Parámetros de entrada
url
Un enlace al perfil de redes sociales del prospecto. Especifica el nombre de la red social entre [corchetes] (LinkedIn o X).
Ejemplos de código
<?php
function getEmailsFromUrl()
{
    $token = getAccessToken();

    $params = [
        'access_token' => $token,
        'url'          => 'https://www.linkedin.com/in/john-doe-123456/'
    ];


    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/get-emails-from-url',
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);
    curl_close($ch);

    return $res;

}
?>
def get_emails_from_url():
token = get_access_token()
params = {'access_token':token,
          'url':'https://www.linkedin.com/in/elie-ohayon-aaab7341'
}

res = requests.post('https://api.snov.io/v1/get-emails-from-url', data=params)

return json.loads(res.text)
Ejemplo de respuesta
{
  "success": true,
  "data": [
    {
      "id": "xusD3-T_K5IktGoaa8Jc8A==",
      "name": "Gavin Vanrooyen",
      "firstName": "John",
      "lastName": "Doe",
      "sourcePage": "https://www.linkedin.com/in/john-doe-123456/",
      "source": "linkedIn",
      "industry": "Entertainment",
      "country": "United States",
      "locality": "Greater Atlanta Area",
      "lastUpdateDate": {
        "date": "2019-09-11 12:37:58.000000",
        "timezone_type": 3,
        "timezone": "UTC"
      },
      "currentJob": [
        {
          "companyName": "Octagon",
          "position": "Senior Brand Director",
          "socialLink": "https:\/\/www.linkedin.com\/company\/659333",
          "site": "http:\/\/octagon.com",
          "locality": "United States",
          "state": null,
          "city": null,
          "street": null,
          "street2": null,
          "postal": null,
          "founded": null,
          "startDate": "2018-07-31",
          "endDate": null,
          "size": "1-10",
          "industry": "Entertainment",
          "companyType": "Public Company",
          "country": "United States"
        }
      ],
      "previousJob": [
        {
          "companyName": "UPS",
          "position": "Manager, Sponsorships and Events",
          "socialLink": "https:\/\/www.linkedin.com\/company\/1523574",
          "site": "http:\/\/www.ups.com\/",
          "locality": "United States",
          "state": "GA",
          "city": "Atlanta",
          "street": "55 Glenlake Parkway, NE",
          "street2": null,
          "postal": "30328",
          "founded": "1907",
          "startDate": null,
          "endDate": null,
          "size": "10001+",
          "industry": "Logistics and Supply Chain",
          "companyType": "Public Company",
          "country": "United States"
        }
      ],
        "social": [],
        "emails": [
            {
                "email": "johndoe@octagon.com",
                "status": "valid"
            }
        ]
    }
  ]
}
Parámetros de salida
success
Es
true
si se encuentra el prospecto
id
Identificador único del perfil
name
Nombre completo del prospecto
firstName
Primer nombre del prospecto
lastName
Apellido del prospecto
industry
Sector de actividad indicado en el perfil del prospecto
country
País de prospecto
locality
Ubicación del prospecto
skills
Habilidades del prospecto
social
Enlaces a los perfiles sociales de los prospectos
currentJobs
La matriz contiene información sobre el puesto de trabajo actual de prospecto
previousJobs
La matriz contiene información sobre los cargos anteriores del prospecto
lastUpdateDate
Fecha de la última actualización del perfil
emails
Correo electrónico del prospecto con el estado actual

POSTObtén el perfil con el email

1 crédito por solicitud

Proporcionar una dirección de correo electrónico y Snov.io devolverá toda la información del perfil conectado al propietario de la dirección de correo electrónico proporcionada de la base de datos.

Si no encontramos información sobre el propietario del correo electrónico en nuestra base de datos, no se le cobrará por la solicitud.

Solicitud
POSThttps://api.snov.io/v1/get-profile-by-email
Parámetros de entrada
email
La dirección de correo electrónico de la persona sobre la que desea encontrar información adicional.
Ejemplos de código
<?php
function getProfileByEmail()
{
    $token = getAccessToken();

    $params = [
        'access_token'    => $token,
        'email'           => 'gavin.vanrooyen@octagon.com'
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/get-profile-by-email',
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);
    curl_close($ch);
    
    return $res;

}
?>
def get_profile_by_email():
token = get_access_token()
params = {'access_token':token,
        'email':'gavin.vanrooyen@octagon.com'
}

res = requests.post('https://api.snov.io/v1/get-profile-by-email', data=params)

return json.loads(res.text)
Ejemplo de respuesta
{
"success": true,
"id": 301592,
"source": "linkedIn",
"name": "Lizi Hamer",
"firstName": "Lizi",
"lastName": "Hamer",
"logo": "https://app.snov.io/img/peoples/010fcf23c70dfa68d880545ec89a9215.jpg",
"industry": null,
"country": "Singapore",
"locality": "Singapore",
"social": [
    {
        "link": "https://www.linkedin.com/in/lizihamer/",
        "type": "linkedIn"
    },
    {
        "link": "https://twitter.com/LiziHamer",
        "type": "twitter"
    }
],
"currentJobs": [
    {
        "companyName": "Octagon",
        "position": "Regional Creative Director",
        "socialLink": "https://www.linkedin.com/company/165282",
        "site": "www.octagon.com",
        "locality": "Greater New York City Area",
        "state": "Connecticut",
        "city": "Stamford",
        "street": "290 Harbor Dr",
        "street2": "2nd Floor",
        "postal": "06902",
        "founded": "1983",
        "startDate": "2016-01-31",
        "endDate": null,
        "size": "1-10",
        "industry": "Marketing and Advertising",
        "companyType": "Public Company",
        "country": "United States"
    },
    {
        "companyName": "SisuGirls",
        "position": "Co Founder",
        "socialLink": "https://www.linkedin.com/company/3841118",
        "site": "http://www.sisugirls.org",
        "locality": null,
        "state": "SG",
        "city": "Singapore",
        "street": "33-03 Hong Leong Building",
        "street2": null,
        "postal": null,
        "founded": "2014",
        "startDate": "2015-07-31",
        "endDate": null,
        "size": "1-10",
        "industry": "Health, Wellness and Fitness",
        "companyType": null,
        "country": "Singapore"
    }
],
"previousJobs": [
    {
        "companyName": "Fusion Co-innovation Labs",
        "position": "Creative Entrepreneur",
        "socialLink": null,
        "site": null,
        "locality": null,
        "state": null,
        "city": null,
        "street": null,
        "street2": null,
        "postal": null,
        "founded": null,
        "startDate": "2013-05-31",
        "endDate": "2013-10-31",
        "size": null,
        "industry": null,
        "companyType": null,
        "country": null
    },
    {
        "companyName": "Russell Commission",
        "position": "Youth Advisory Board Member",
        "socialLink": null,
        "site": null,
        "locality": null,
        "state": null,
        "city": null,
        "street": null,
        "street2": null,
        "postal": null,
        "founded": null,
        "startDate": "2004-06-30",
        "endDate": "2006-06-30",
        "size": null,
        "industry": null,
        "companyType": null,
        "country": null
    }
],
"lastUpdateDate": "2018-02-07 10:12:28"
}
Parámetros de salida
id
Un identificador de perfil único.
source
La fuente de los datos personales recuperados.
name
El nombre completo del propietario de la dirección de correo electrónico.
firstName
El nombre de la persona.
lastName
El apellido de la persona.
logo
La foto de perfil de la persona.
industry
El sector de la persona indicado en la fuente.
country
El país de la persona como se indica en la fuente.
locality
La localidad de la persona como se indica en la fuente.
social
Enlaces a los perfiles sociales de la persona.
currentJobs
Una matriz que contiene información sobre el o los puestos de trabajo actuales de la persona.
previousJobs
Una matriz que contiene información sobre los puestos de trabajo anteriores de la persona.
lastUpdateDate
La fecha de la última actualización del perfil en la base de datos.

POSTVerificar emails

Ingresa direcciones de email y Snov.io realizará una verificación completa. Puedes verificar hasta 10 emails al mismo tiempo.

Proporcionando emails

POSThttps://api.snov.io/v2/email-verification/start
Parámetros de entrada
emails[]
Emails que deseas verificar.
Para recuperar dominios de múltiples empresas, agrega cada una como un parámetro separado. Por ejemplo:
emails[] | help@snov.io
emails[] | partnerships@snov.io
Puedes proporcionar hasta 10 nombres de empresas al mismo tiempo.
webhook_url
Ingresa tu URL de webhook para recibir resultados de inmediato en lugar de usar una tarea de hash.
Ejemplos de código
<?php
function emailVerificationStart()
{
    $token = getAccessToken();

    $params = [
        'emails'    => ['gavin.vanrooyen@octagon.com','lizi.hamer@octagon.com','admin@snov.io','test@snov.io','ivalid_format_snov.io'],
        'webhook_url'         => 'https://hooks.yourdomain.com',
    ];

    $headers = [
        'Authorization: Bearer ' . $token,
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v2/email-verification/start',
        CURLOPT_HTTPHEADER     => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => http_build_query($params),
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $response = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $response;
}
?>
def email_verification_start():
token = get_access_token()
headers = {'authorization': f'Bearer {token}'}
params = {
  'emails[]': ['gavin.vanrooyen@octagon.com', 'lizi.hamer@octagon.com', 'admin@snov.io', 'test@snov.io', 'ivalid_format_snov.io'],
  'webhook_url': 'https://hooks.yourdomain.com',
}
res = requests.post('https://api.snov.io/v2/email-verification/start', params=params, headers=headers)

return json.loads(res.text)
Ejemplo de respuesta
{
  "data": {
    "task_hash": "0110437df6811068197577a538849a4b"
  },
  "meta": {
    "emails": [
      "gavin.vanrooyen@octagon.com",
      "lizi.hamer@octagon.com",
      "admin@snov.io",
      "test@snov.io",
      "ivalid_format_snov.io"
    ]
  }
}
Parámetros de salida
task_hash
ID único para la tarea de búsqueda que iniciaste.
emails
Un array de emails que proporcionaste para verificación.
Recibiendo resultados de verificación.
GEThttps://api.snov.io/v2/email-verification/result
Parámetros de entrada
task_hash
ID de solicitud único que recibiste de la solicitud anterior.
Ejemplos de código
<?php
function emailVerificationResult()
{
    $token = getAccessToken();

    $task_hash = '0110437df6811068197577a538849a4b';

    $headers = [
        'Authorization: Bearer ' . $token,
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v2/email-verification/result?task_hash=$task_hash',
        CURLOPT_HTTPHEADER     => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $response = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $response;
}
?>
def email_verification_result():
token = get_access_token()
task_hash = 'b55b28d5419a1c3ec310f21916e4e271'
headers = {'authorization': f'Bearer {token}'}
params = {
  'task_hash': task_hash
}

res = requests.get(f'https://api.snov.io/v2/email-verification/result', params=params, headers=headers)

return json.loads(res.text)
Ejemplo de respuesta
{
  "status": "completed",
  "data": [
    {
      "email": "gavin.vanrooyen@octagon.com",
      "result": {
        "is_webmail": false,
        "smtp_status": "unknown",
        "is_gibberish": false,
        "is_disposable": false,
        "is_valid_format": true,
        "unknown_status_reason": "catchall"
      }
    },
    {
      "email": "admin@snov.io",
      "result": {
        "is_webmail": false,
        "smtp_status": "valid",
        "is_gibberish": false,
        "is_disposable": false,
        "is_valid_format": true
      }
    },
    {
      "email": "ivalid_format_snov.io",
      "result": {
        "is_webmail": false,
        "smtp_status": "not_valid",
        "is_gibberish": false,
        "is_disposable": false,
        "is_valid_format": false
      }
    },
    {
      "email": "lizi.hamer@octagon.com",
      "result": {
        "is_webmail": false,
        "smtp_status": "unknown",
        "is_gibberish": false,
        "is_disposable": false,
        "is_valid_format": true,
        "unknown_status_reason": "catchall"
      }
    },
    {
      "email": "test@snov.io",
      "result": {
        "smtp_status": "unknown",
        "is_valid_format": true,
        "is_disposable": false,
        "is_webmail": false,
        "is_gibberish": true,
        "unknown_status_reason": "banned"
      }
    }
  ],
  "meta": {
    "emails": [
      "gavin.vanrooyen@octagon.com",
      "lizi.hamer@octagon.com",
      "admin@snov.io",
      "test@snov.io",
      "ivalid_format_snov.io"
    ],
    "task_hash": "0110437df6811068197577a538849a4b"
  }
}
Parámetros de salida
status
Estado de la solicitud. Puede ser completed o in_progress.
email
Dirección de email que estás verificando.
smtp_status
Puede devolver valid, not_valid o unknown (también conocido como no verificable).
Para ver la razón del estado desconocido, revisa el parámetro unknown_status_reason.
is_valid_format
Muestra si el formato del email es válido. Puede ser false o true.
is_disposable
Indica si un email es temporal o desechable, devolviendo false o true.
is_webmail
Es true si el email que estás buscando es webmail.
is_gibberish
Muestra si la dirección de email proporcionada tiene caracteres aleatorios o sin sentido. Será false o true.
unknown_status_reason
Si un email verificado tiene un smtp_status desconocido, puedes encontrar una razón más detallada aquí.
Banned: Alto riesgo de entregabilidad - este email no se pudo verificar con un 100% de certeza.
Catchall: Riesgo de reputación del remitente - este email es un catch-all.
Connection_error: Riesgo de rebote potencial - problemas técnicos del lado del destinatario.
Greylist: Riesgo de entregabilidad - este servidor de email utiliza filtros de lista gris.
Hidden_by_owner: El propietario del email o la empresa que posee el dominio solicitó su eliminación de los resultados de Snov.io.
emails
Un array de emails que estás verificando.
task_hash
ID de solicitud único para esta tarea de verificación.

POSTEncuentra el dominio del nombre de la empresa

1 crédito por cada dirección de dominio encontrada

Ingresa los nombres de las empresas y Snov.io devolverá sus direcciones de dominio.

Proporcionando nombres de empresas
POSThttps://api.snov.io/v2/company-domain-by-name/start
Parámetros de entrada
names[]
Un array de nombres de empresas para las que deseas recibir los dominios.
Para recuperar dominios de múltiples empresas, agrega cada una como un parámetro separado. Por ejemplo:
names[] | Snov.io
names[] | Sendpulse
Puedes proporcionar hasta 10 nombres de empresas al mismo tiempo.
webhook_url
Ingresa tu URL de webhook para recibir resultados de inmediato en lugar de usar una tarea de hash.
Ejemplos de código
<?php
function companyDomainByNameStart()
{
    $token = getAccessToken();

    $params = [
        'names'    => ['Snov.io','SendPulse'],
        'webhook_url'         => 'https://hooks.yourdomain.com',
    ];

    $headers = [
        'Authorization: Bearer ' . $token,
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v2/company-domain-by-name/start',
        CURLOPT_HTTPHEADER     => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => http_build_query($params),
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $response = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $response;
}
?>
def company_domain_by_name_start():
token = get_access_token()
headers = {'authorization': f'Bearer {token}'}
params = {
  'webhook_url': 'https://hooks.yourdomain.com',
  'names[]': ['Snov.io', 'Sendpulse']
}

res = requests.post('https://api.snov.io/v2/company-domain-by-name/start', params=params, headers=headers)

return json.loads(res.text)
Ejemplo de respuesta
{
  "data": {
    "task_hash": "959c0f60facb8629bba746e091a26f7b"
  },
  "meta": {
    "names": [
      "Snov.io",
      "Sendpulse"
    ]
  }
}
Parámetros de salida
task_hash
ID único para la tarea de búsqueda que iniciaste.
names
Un array de nombres de empresas que proporcionaste.
Recibiendo dominios de empresas
GEThttps://api.snov.io/v2/company-domain-by-name/result?task_hash={hash_from_1}
Parámetros de entrada
task_hash
ID de solicitud único que recibiste de la solicitud anterior.
Ejemplos de código
<?php
function companyDomainByNameResult()
{
    $token = getAccessToken();

    $task_hash = '48c156a785cfc1f3b0edab2cc28b3774';

    $headers = [
        'Authorization: Bearer ' . $token,
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v2/company-domain-by-name/result?task_hash=$task_hash',
        CURLOPT_HTTPHEADER     => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $response = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $response;
}
?>
def company_domain_by_name_result():
token = get_access_token()
task_hash = '959c0f60facb8629bba746e091a26f7b'
headers = {'authorization': f'Bearer {token}'}
params = {
  'task_hash': task_hash
}

res = requests.get(f'https://api.snov.io/v2/company-domain-by-name/result', params=params, headers=headers)

return json.loads(res.text)
Ejemplo de respuesta
{
  "status": "completed",
  "data": [
    {
      "name": "Snov.io",
      "result": {
        "domain": "snov.io"
      }
    },
    {
      "name": "Sendpulse",
      "result": {
        "domain": "sendpulse.com"
      }
    }
  ],
  "meta": {
    "names": [
      "Snov.io",
      "Sendpulse"
    ],
    "task_hash": "959c0f60facb8629bba746e091a26f7b"
  }
}
Parámetros de salida
status
Estado de la solicitud. Puede ser completed o in_progress.
name
Nombre de la empresa para la que solicitaste una dirección de dominio.
domain
Dominio de la empresa.
names
Un array de nombres de empresas que proporcionaste.
task_hash
ID único para esta tarea de búsqueda.

POSTObtener información del perfil de LinkedIn desde URLs

1 crédito por cada información del perfil de prospecto proporcionada

Ingresa las URLs de los miembros de LinkedIn y Snov.io recuperará su información de perfil completa.

Proporcionando URLs de LinkedIn
POSThttps://api.snov.io/v2/li-profiles-by-urls/start
Parámetros de entrada
urls[]
Un array de URLs de perfiles de LinkedIn para las que deseas recibir la información completa del perfil.
Para recuperar información de perfil de múltiples miembros de LinkedIn al mismo tiempo, agrega cada URL como un parámetro separado.
Puedes proporcionar hasta 10 URLs de LinkedIn al mismo tiempo.
webhook_url
Ingresa tu URL de webhook para recibir resultados de inmediato en lugar de usar una tarea de hash.
Ejemplos de código
<?php
function linkedInProfilesByUrlsStart()
{
    $token = getAccessToken();

    $params = [
        'urls'    => ['https://www.linkedin.com/in/oleksii-kratko-6a0544187/','https://www.linkedin.com/in/atahualpamaia/'],
        'webhook_url'         => 'https://hooks.yourdomain.com',
    ];

    $headers = [
        'Authorization: Bearer ' . $token,
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v2/li-profiles-by-urls/start',
        CURLOPT_HTTPHEADER     => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => http_build_query($params),
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $response = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $response;
}
?>
def linkedin_profiles_by_urls_start():
token = get_access_token()
headers = {'authorization': f'Bearer {token}'}
params = {
  'urls[]': ['https://www.linkedin.com/in/atahualpamaia/', 'https://www.linkedin.com/in/oleksii-kratko-6a0544187/'],
  'webhook_url': 'https://hooks.yourdomain.com',
}

res = requests.post('https://api.snov.io/v2/li-profiles-by-urls/start', params=params, headers=headers)

return json.loads(res.text)
Ejemplo de respuesta
{
  "data": {
    "task_hash": "ef005a4f6d82e7e88384de7c72ee198d"
  },
  "meta": {
    "urls": [
      "https://www.linkedin.com/in/john-doe-32a416248/",
      "https://www.linkedin.com/in/john-doe-04bb56b1/",
      "https://www.linkedin.com/in/john-jungwoo-do/"
    ]
  }
}
Parámetros de salida
task_hash
ID único para la tarea de búsqueda que iniciaste.
urls
URLs de perfiles para los que estás solicitando la información.
Recibiendo información del perfil
GEThttps://api.snov.io/v2/li-profiles-by-urls/result
Parámetros de entrada
task_hash
ID de solicitud único que recibiste de la solicitud anterior.
Ejemplos de código
<?php
function linkedInProfilesByUrlsResult()
{
    $token = getAccessToken();

    $task_hash = 'ef005a4f6d82e7e88384de7c72ee198d';

    $headers = [
        'Authorization: Bearer ' . $token,
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v2/li-profiles-by-urls/result?task_hash=$task_hash',
        CURLOPT_HTTPHEADER     => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $response = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $response;
}
?>
def linkedin_profiles_by_urls_result():
token = get_access_token()
task_hash = '879788bd889b0b9aa447278ce184e2ad'
headers = {'authorization': f'Bearer {token}'}
params = {
  'task_hash': task_hash
}

res = requests.get(f'https://api.snov.io/v2/li-profiles-by-urls/result', params=params, headers=headers)

return json.loads(res.text)
Ejemplo de respuesta
{
  "status": "completed",
  "data": [
    {
      "url": "https://www.linkedin.com/in/john-doe-32a416248/",
      "result": {
        "name": "John Doe",
        "first_name": "John",
        "last_name": "Doe",
        "industry": "Internet",
        "location": "Chicago, Illinois, United States",
        "country": "United States",
        "positions": [
          {
            "name": "Stealth Startup",
            "title": "CEO",
            "linkedin_url": "https://www.linkedin.com/company/18583501",
            "url": "https://www.linkedin.com/in/ruhbirsingh/",
            "industry": "Computer Software",
            "country": "India",
            "location": "Gurugram, Haryana, India"
          },
          {
            "name": "TikTok",
            "title": "Influencer",
            "linkedin_url": "https://www.linkedin.com/company/33246798",
            "url": "https://www.tiktok.com/about?lang=en",
            "industry": "Entertainment",
            "country": "United States",
            "location": "Los Angeles, California, United States"
          }
        ]
      }
    },
    {
      "url": "https://www.linkedin.com/in/john-doe-04bb56b1/",
      "result": []
    },
    {
      "url": "https://www.linkedin.com/in/john-jungwoo-do/",
      "result": {
        "name": "John Do",
        "first_name": "John",
        "last_name": "Do",
        "location": "Vancouver, British Columbia, Canada",
        "country": "Canada",
        "skills": [
          "communication",
          "java"
        ],
        "positions": [
          {
            "name": "UBC Electrical and Computer Engineering",
            "title": "Undergraduate Research Assistant",
            "linkedin_url": "https://www.linkedin.com/company/15134449",
            "url": "http://www.ece.ubc.ca",
            "industry": "Higher Education",
            "country": "Canada",
            "location": "Vancouver, British Columbia, Canada"
          },
          {
            "name": "The University of British Columbia",
            "title": "Undergraduate Teaching Assistant",
            "linkedin_url": "https://www.linkedin.com/company/4373",
            "url": "http://www.ubc.ca",
            "industry": "Higher Education",
            "country": "Canada",
            "location": "Vancouver, British Columbia, Canada",
            "specializations": [
              "Aboriginal Engagement",
              "Alumni Engagement",
              "Community Engagement",
              "Intercultural Understanding",
              "International Engagement",
              "Outstanding Work Environment",
              "Research Excellence",
              "Student Learning",
              "sustainability"
            ]
          }
        ]
      }
    },
    {
      "url": "https://www.linkedin.com/in/john-doe-474006162/",
      "result": []
    }
  ],
  "meta": {
    "urls": [
      "https://www.linkedin.com/in/john-doe-32a416248/",
      "https://www.linkedin.com/in/john-doe-04bb56b1/",
      "https://www.linkedin.com/in/john-jungwoo-do/",
      "https://www.linkedin.com/in/john-doe-474006162/"
    ],
    "task_hash": "8a60c72133d0ea94767e4a978355c630"
  }
}
Parámetros de salida
status
Estado de la solicitud. Puede ser completed o in_progress.
url
URL del perfil de LinkedIn.
name
Nombre completo del prospecto.
first_name
Nombre del prospecto.
last_name
Apellido del prospecto.
industry
Campo de trabajo del prospecto.
location
Ubicación del prospecto.
country
País donde se basa el prospecto, según su perfil de LinkedIn.
skills
Habilidades del prospecto.
positions
Array de roles laborales que ocupa actualmente el prospecto.
name
El nombre de la empresa para la que trabaja el prospecto.
title
Título del trabajo del prospecto.
linkedin_url
Enlace a la página de LinkedIn de la empresa.
url
Dirección del sitio web de la empresa.
industry
Industria de la empresa.
country
País donde se encuentran las oficinas centrales de la empresa.
location
Ubicación de la empresa.
specializations
Áreas de especialización o enfoque de la empresa.
urls
1 crédito por cada verificación
task_hash
ID único para esta tarea de búsqueda.

GETObtén análisis de la campaña

Gratis

Este método muestra las estadísticas de la campaña según los filtros aplicados.

Solicitud
GEThttps://api.snov.io/v2/statistics/campaign-analytics
Parámetros de entrada
campaign_id
ID de la campaña. Puedes encontrarlo en la URL cuando veas la información de la campaña (ejemplo). Si dejas este campo vacío, obtendrás datos de todas las campañas activas dentro del período de tiempo especificado.

Para obtener datos de varias campañas, separa los ID con comas.
sender_email
ID de la cuenta de correo del remitente. Puedes encontrarlo en la URL al ver o editar la información de la cuenta de email (ejemplo). Para ver las analíticas de varias cuentas de correo, separa los ID con comas.

Alternativamente, deja este parámetro vacío si no deseas aplicar un filtro de cuenta de email.
sender_linkedin
ID de cuenta de LinkedIn del remitente. Puedes encontrarlo en la URL al ver o editar la información de la cuenta de LinkedIn. Para ver las analíticas de varias cuentas, separa los IDs con comas.

Deja este parámetro vacío si no deseas aplicar un filtro de cuenta de LinkedIn.
campaign_owner
Para ver los datos de la campaña de un miembro específico del equipo, ingresa la dirección de email. Para filtrar por múltiples propietarios de campañas, lista las direcciones de email separadas por comas (sin espacios).

Ejemplo: example1@gmail.com,example2@gmail.com

Ten en cuenta que para utilizar este filtro, tu cuenta debe tener habilitado el permiso de ‘Ver registros del equipo’, y debe estar en un plan Pro o superior.
date_from
La fecha de inicio del período para el cual deseas recibir estadísticas. Formato: aaaa-mm-dd. Déjalo vacío para recibir estadísticas de todo el tiempo.
date_to
La fecha de finalización del período para el cual deseas recibir estadísticas. Formato: aaaa-mm-dd. Déjeao vacío para recibir estadísticas todo el tiempo.
Ejemplos de código

<?php

function getCampaignAnalytics()

{

   $token = getAccessToken();

   $campaignIds = [1, 2];

   $senderEmailIds = [21, 22];

   $senderLinkedInIds = [31, 32, 33];

   $ownerEmails = ['owner1@email.loc', 'owner2@email.loc'];

   $params = [

       'access_token' => $token,

       'campaign_id' => implode(',', $campaignIds),

       'sender_email' => implode(',', $senderEmailIds),

       'sender_linkedin' => implode(',', $senderLinkedInIds),

       'campaign_owner' => implode(',', $ownerEmails),

       'date_from' => '2024-06-15',

       'date_to' => '2024-09-15',

   ];

   $params = http_build_query($params);

   $options = [

       CURLOPT_URL => 'https://api.snov.io/v2/statistics/campaign-analytics?' . $params,

       CURLOPT_RETURNTRANSFER => true,

       CURLOPT_FOLLOWLOCATION => true

   ];

   $ch = curl_init();

   curl_setopt_array($ch, $options);

   $res = json_decode(curl_exec($ch), true);

   curl_close($ch);

   return $res;

}

?>

def get_campaign_analytics():

   token = get_access_token()

   campaign_ids = [1, 2]

   sender_email_ids = [21, 22]

   sender_linkedin_ids = [31, 32, 33]

   owner_emails = ['owner1@email.loc', 'owner2@email.loc']

   params = {

       'access_token': token,

       'campaign_id': ','.join(map(str, campaign_ids)),

       'sender_email': ','.join(map(str, sender_email_ids)),

       'sender_linkedin': ','.join(map(str, sender_linkedin_ids)),

       'campaign_owner': ','.join(owner_emails),

       'date_from': '2024-06-15',

       'date_to': '2024-09-15',

   }

   res = requests.get('https://api.snov.io/v2/statistics/campaign-analytics', params=params)

   return json.loads(res.text)

Ejemplo de respuesta
{
    "total_contacted": 32,
    "emails_sent": 31,
    "first_emails": 24,
    "first_emails_rate": "77%",
    "follow_ups": 7,
    "follow_ups_rate": "23%",
    "delivered": 30,
    "delivered_rate": "97%",
    "bounced": 1,
    "bounced_rate": "3%",
    "contacted_by_email": 23,
    "email_opens": 16,
    "email_opens_rate": "70%",
    "link_clicks": 0,
    "link_clicks_rate": "0%",
    "email_replies": 16,
    "email_replies_rate": "70%",
    "unsubscribed": 0,
    "unsubscribed_rate": "0%",
    "auto_replied": 0,
    "auto_replied_rate": "0%",
    "contacted_by_linkedin": 10,
    "linkedin_total_replies": 9,
    "linkedin_total_replies_rate": "90%",
    "connection_request_replies": 2,
    "connection_request_replies_rate": "22%",
    "message_replies": 7,
    "message_replies_rate": "78%",
    "in_mail_replies": 0,
    "in_mail_replies_rate": "0%",
    "connection_requests": 2,
    "accepted_requests": 2,
    "accepted_requests_rate": "100%",
    "failed_connection_requests": 0,
    "messages_sent": 9,
    "linkedin_views": 9,
    "linkedin_likes": 0,
    "linkedin_follows": 0,
    "in_mail_sent": 0,
    "interested": 8,
    "interested_rate": "32%",
    "maybe": 8,
    "maybe_rate": "32%",
    "not_interested": 4,
    "not_interested_rate": "16%"
}
Parámetros de salida
total_contacted
Número total de destinatarios que fueron contactados por email o LinkedIn (solicitud de conexión, mensaje o InMail).
emails_sent
Número total de emails enviados a través de las campañas.

Ten en cuenta que esto no incluye los emails enviados fuera de las campañas.
first_emails
Número de primeros emails en una secuencia de campaña que fueron enviados dentro del período de tiempo indicado.
first_emails_rate
Porcentaje de primeros emails sobre el total de emails enviados.
follow_ups
Número de emails de seguimiento en una secuencia de campaña que se enviaron dentro del período de tiempo indicado.
follow_ups_rate
Porcentaje de emails de seguimiento respecto al total deemails enviados.
delivered
Número de emails enviados que no rebotaron.
delivered_rate
Porcentaje de emails que no rebotaron del total de emails enviados.
bounced
Número de emails que rebotaron.
bounced_rate
Porcentaje de emails que rebotaron en relación con el total de emails enviados.
contacted_by_email
Número de destinatarios que recibieron al menos un email que no rebotó.
email_opens
Número de destinatarios que abrieron tu email al menos una vez.
email_opens_rate
Porcentaje de destinatarios que abrieron tu email al menos una vez, en relación con todos los destinatarios contactados.
link_clicks
Número de destinatarios que hicieron clic en al menos un enlace en tus campañas.
link_clicks_rate
Porcentaje de destinatarios que hicieron clic en al menos un enlace en las campañas, en relación con el total de destinatarios contactados.
email_replies
Número de destinatarios que respondieron al menos una vez.
email_replies_rate
Porcentaje de destinatarios que respondieron al menos una vez de todos los destinatarios contactados.
unsubscribed
Número de destinatarios que hicieron clic en el enlace de "Cancelar suscripción" en tus campañas, optando por no recibir más emails.
unsubscribed_rate
Porcentaje de destinatarios que hicieron clic en el enlace de "Cancelar suscripción" en tus campañas, de todos los destinatarios contactados.
auto_replied
Número de destinatarios que respondieron automáticamente a los emails de tu campaña.
auto_replied_rate
Porcentaje de destinatarios que respondieron automáticamente de todos los destinatarios contactados.
contacted_by_linkedin
Número de destinatarios a quienes enviaste al menos un mensaje o solicitud de conexión en LinkedIn.
linkedin_total_replies
Número de destinatarios que respondieron al menos una vez a cualquiera de los mensajes enviados en LinkedIn (mensajes de LinkedIn, mensajes de solicitud de conexión e InMail).
linkedin_total_replies_rate
Porcentaje de destinatarios que respondieron al menos una vez a cualquiera de los mensajes enviados en LinkedIn (mensajes de LinkedIn, mensajes de solicitud de conexión e InMail).
connection_request_replies
Número de destinatarios que respondieron a un mensaje de solicitud de conexión.
connection_request_replies_rate
Porcentaje de destinatarios que respondieron a un mensaje de solicitud de conexión de todos los destinatarios contactados.
message_replies
Número de destinatarios que respondieron a un mensaje regular de LinkedIn.
message_replies_rate
Porcentaje de destinatarios que respondieron a un mensaje regular de LinkedIn de todos los destinatarios contactados.
in_mail_replies
Número de destinatarios que respondieron a un mensaje InMail en LinkedIn.
in_mail_replies_rate
Porcentaje de destinatarios que respondieron a un mensaje InMail en LinkedIn.
connection_requests
Número de solicitudes de conexión enviadas a prospectos a través de campañas de Snov.io.
accepted_requests
Número de solicitudes de conexión que fueron aceptadas por miembros de LinkedIn.
accepted_requests_rate
Porcentaje de solicitudes de conexión que fueron aceptadas de todas las solicitudes enviadas.
failed_connection_requests
Número de solicitudes de conexión en LinkedIn que no se enviaron debido a:
  • la URL de LinkedIn del prospecto no existe
  • ya les enviaste una solicitud de conexión anteriormente y está pendiente
  • ya estás conectado con el prospecto
messages_sent
Número de mensajes enviados en LinkedIn.
linkedin_views
Número de perfiles de prospectos visualizados.
linkedin_likes
Número de publicaciones de prospectos con "me gusta" en LinkedIn.
linkedin_follows
Número de perfiles de prospectos seguidos.
in_mail_sent
Número total de mensajes InMail enviados.
interested
Número de destinatarios que mostraron interés en sus respuestas.
interested_rate
Porcentaje de destinatarios que mostraron interés en sus respuestas.
maybe
Número de destinatarios que no expresaron interés ni desinterés directo en sus respuestas.
maybe_rate
Porcentaje de destinatarios que no expresaron interés ni desinterés directo en sus respuestas.
not_interested
Número de destinatarios que no mostraron interés en sus respuestas.
not_interested_rate
Porcentaje de destinatarios que no mostraron interés en sus respuestas.

GETVer el progreso de la campaña

Gratis

Este método devuelve el progreso y el estado de la campaña.

Solicitud
GEThttps://api.snov.io/v2/campaigns/[campaign_id]/progress
Parámetros de entrada
campaign_id
*Requerido
ID de la campaña. Puedes encontrarlo en la URL cuando ves la información de la campaña (ejemplo).
Ejemplos de código

<?php

function getCampaignProgress()

{

   $token = getAccessToken();

   $campaignId = 1;

   $params = [

       'access_token' => $token,

   ];

   $params = http_build_query($params);

   $options = [

       CURLOPT_URL => "https://api.snov.io/v2/campaigns/$campaignId/progress?" . $params,

       CURLOPT_RETURNTRANSFER => true,

       CURLOPT_FOLLOWLOCATION => true

   ];

   $ch = curl_init();

   curl_setopt_array($ch, $options);

   $res = json_decode(curl_exec($ch), true);

   curl_close($ch);

   return $res;

}

?>

def get_campaign_progress():

   token = get_access_token()

   campaign_id = 1

   params = {

       'access_token': token,

   }

   res = requests.get(f"https://api.snov.io/v2/campaigns/{campaign_id}/progress", params=params)

   return json.loads(res.text)

Ejemplo de respuesta
{
    "status":"Active",
    "unfinished":1,
    "progress":"90%"
}
Parámetros de salida
progress
Porcentaje de destinatarios que:
  • Llegaron al final de la secuencia
  • Rebotaron, respondieron, auto-respondieron, se dieron de baja, fueron eliminados o movidos de la campaña, por lo que la campaña fue detenida para ellos.
unfinished
Número de destinatarios en la campaña que no llegaron al final de la secuencia o para quienes la secuencia no fue detenida.
status
Estado de la campaña. Aprende más

POSTCambia el estado del destinatario

Gratis

Cambiar el estado de un destinatario en una campaña específica.

Solicitud
POSThttps://api.snov.io/v1/change-recipient-status
Parámetros de entrada
email
*Requerido
La dirección de correo electrónico del prospecto.
campaign_id
*Requerido
El identificador de la campaña. Puedes encontrarlo en la URL cuando veas la información de la campaña (mostrar un ejemplo).
status
*Requerido
Puede contener Activo, Pausado o No suscrito. No puedes cambiar el estado de los destinatarios si su estado es Finalizado o Movido.
Ejemplos de código
<?php
function changeRecipientStatus()
{
    $token = getAccessToken();

    $params = [
        'access_token' => $token,
        'email'       => 'gavin.vanrooyen@octagon.com',
        'campaign_id'    => '179025',
        'status'     => 'Paused'
    ];


    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/change-recipient-status',
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);
    curl_close($ch);

    return $res;

}
?>
def change_recipient_status():
token = get_access_token()
params = {'access_token':token,
          'email':'gavin.vanrooyen@octagon.com',
          'campaign_id': '179025',
          'status':'Paused'
}

res = requests.post('https://api.snov.io/v1/change-recipient-status', data=params)

return json.loads(res.text)
Ejemplo de respuesta
{
  "success": true
}
Parámetros de salida

El método devuelve success: true si el estado del prospecto ha sido cambiado con éxito. Si se produce algún error, el método devolverá success: false con una descripción del error.

GETVer lista de prospectos completados

Gratis

Este método devuelve los prospectos para los que se ha completado la campaña.

Solicitud
GEThttps://api.snov.io/v1/prospect-finished
Parámetros de entrada
campaignId
*Requerido
El identificador único de la campaña para recuperar la lista de prospectos.
Ejemplos de código
<?php
function finishedProspects()
{
    $token = getAccessToken();

    $params = [
        'access_token' => $token,
        'campaignId'   => 1234567
    ];

    $params = http_build_query($params);

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/prospect-finished?'.$params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true,
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $res;

}
?>
def user_lists():
token = get_access_token()
params = {'access_token':token,
        'campaignId':1234567
}

res = requests.get('https://api.snov.io/v1/prospect-finished', data=params)

return json.loads(res.text)
Ejemplo de respuesta
[
    {
        "id": "88c268d404797d1001b4d72806207625",
        "prospectId": "9c2eb5b46bb5873e408684dd577d002354e4f7026f47bf8a592d659bba3d2dd0ff186b90dc7a5",
        "userName": "zach Jones",
        "userEmail": "zach@entselect.us",
        "campaign": "Zipari - Salesforce Developer",
        "hash": "f3967971cbab6e769b5f7e3457d00159"
    }
]
Parámetros de salida
id
Identificador único de la solicitud.
prospectId
Identificador único del prospecto.
userName
Nombre completo del prospecto.
userEmail
Dirección de email del prospecto.
campaign
Nombre de la campaña.

GETVer las respuestas de la campaña

Gratis

Este método devuelve las respuestas de la campaña con toda la información, incluyendo el nombre del prospecto, el ID, la campaña, etc.

Solicitud
GEThttps://api.snov.io/v1/get-emails-replies
Parámetros de entrada
campaignId
*Requerido
Identificador único de la campaña de la que quieres ver las respuestas.
offset
Puedes recopilar hasta 10.000 respuestas por cada solicitud. Si tu campaña tiene más respuestas, utiliza el desplazamiento para indicar cuántas respuestas anteriores deseas omitir. Por ejemplo, si tu campaña tiene 20.000 respuestas y deseas solicitar respuestas 10.001-20.000, configura el desplazamiento como 10.000. Si el desplazamiento no se especifica, recibirás las últimas 10.000 respuestas recibidas.
Ejemplos de código
<?php
function campaignReplies()
{
    $token = getAccessToken();

    $params = [
        'access_token' => $token,
        'campaignId'   => 1234567
    ];

    $params = http_build_query($params);

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/get-emails-replies?'.$params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true,
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $res;

}
?>
def user_lists():
token = get_access_token()
params = {'access_token':token,
        'campaignId':1234567
}

res = requests.get('https://api.snov.io/v1/get-emails-replies', data=params)

return json.loads(res.text)
Ejemplo de respuesta
[
    {
        "visitedAt": {
            "date": "2020-07-14 13:10:46.000000",
            "timezone_type": 3,
            "timezone": "UTC"
        },
        "campaignId": 1234567,
        "campaign": "My top campaign",
        "prospectId": "7a941739b09f1187532d52a684df545f3a223e432c7f53662264db8d33db80ee5fc19e573416a",
        "prospectFirstName": "John",
        "prospectLastName": "Doe",
        "prospectName": "John Doe",
        "sourcePage": null,
        "source": "copy",
        "locality": null,
        "industry": "Airlines/Aviation",
        "country": null,
        "prospectEmail": "Johndoe@snov.io",
        "hash": "6745f8162ecadbe325693345d1a53976",
        "emailSubject": "\"Special content for you\"",
        "emailBody": "\"<\p>Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.<\/p>\"",
        "skills": "",
        "links": null,
        "customFields": null,
        "id": "f676edc5de58f341dc7bf4e75c0c8580",
        "customField_fdfd": "",
        "customField_рпа": ""
    }
]
Parámetros de salida
campaignId
Identificador único de la campaña.
campaign
Nombre de la campaña.
prospectName
Nombre completo del prospecto.
emailSubject
Línea de asunto del correo electrónico que recibió una respuesta.
emailBody
Contenido del correo electrónico que ha recibido respuesta.

GETObtén información sobre la apertura de la campaña

Gratis

Este método muestra la información sobre los correos electrónicos abiertos en la campaña.

Solicitud
GEThttps://api.snov.io/v1/get-emails-opened
Parámetros de entrada
campaignId
*Requerido
Identificador único de la campaña de la que deseas ver información sobre las aperturas de los correos electrónicos.
offset
Puedes recopilar hasta 10.000 aperturas por cada solicitud. Si tu campaña tiene más correos electrónicos abiertos, usa el desplazamiento para indicar cuántas aperturas anteriores deseas omitir. Por ejemplo, si tu campaña tiene 20.000 aperturas y quieres solicitar las aperturas 10.001-20.000, configura el desplazamiento como 10.000. Si el desplazamiento no está especificado, recibirás los últimos 10.000 correos electrónicos abiertos.
Ejemplos de código
<?php
function emailsOpen()
{
    $token = getAccessToken();

    $params = [
        'access_token' => $token,
        'campaignId'   => 1234567
    ];

    $params = http_build_query($params);

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/get-emails-opened?'.$params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true,
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $res;

}
?>
def user_lists():
token = get_access_token()
params = {'access_token':token,
        'campaignId':1234567
}

res = requests.get('https://api.snov.io/v1/get-emails-opened', data=params)

return json.loads(res.text)
Ejemplo de respuesta
[
    {
        "visitedAt": {
            "date": "2020-01-08 21:48:14.000000",
            "timezone_type": 3,
            "timezone": "UTC"
        },
        "campaignId": 1234567
        "campaign": "My top campaign",
        "prospectId": "a9e58c3eecff94e617815a90ca412c4c305045102be1312b41fd0073c9c9f3eee30e090bbc3e3",
        "prospectFirstName": "John",
        "prospectLastName": "Doe",
        "prospectName": "John Doe",
        "sourcePage": null,
        "source": "copy",
        "locality": null,
        "industry": null,
        "country": null,
        "prospectEmail": "Johndoe@snov.io",
        "hash": "20b1aeb0e2949fdf7e58363f84b7aff1",
        "emailSubject": "\"Special content for you\"",
        "emailBody": "\"<\p>Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.<\/p>\"",
	"skills": "",
        "links": null,
        "customFields": null,
        "id": "c2a67a47d59745f548ea7b0213c3a81d",
        "customField_Phone": ""
    }
]
Parámetros de salida
campaignId
Identificador único de la campaña.
campaign
Nombre de la campaña.
prospectName
Nombre completo del prospecto que abrió un email.
emailSubject
Línea de asunto del correo electrónico que se abrió.
visitedAt
Hora exacta en que el prospecto abrió el correo electrónico.

GETComprobar los clics del link

Gratis

Este método devuelve información sobre todos los destinatarios de la campaña que han hecho clic en un link en uno de los correos electrónicos de la campaña.

Solicitud
GEThttps://api.snov.io/v1/get-emails-clicked
Parámetros de entrada
campaignId
*Requerido
Identificador único de la campaña para la que desea ver los clics de los links.
offset
Puedes recopilar hasta 10.000 clics por cada solicitud. Si tu campaña tiene más clics, utiliza el desplazamiento para indicar cuántos clics anteriores quieres omitir. Por ejemplo, si tu campaña tiene 20.000 clics y deseas solicitar los clics del 10.001 al 20.000, establece el desplazamiento en 10.000. Si el desplazamiento no se especifica, recibirás los últimos 10.000 correos electrónicos que hicieron clic en un enlace dentro de la campaña.
Ejemplos de código
<?php
function emailsClicked()
{
    $token = getAccessToken();

    $params = [
        'access_token' => $token,
        'campaignId'   => 1234567
    ];

    $params = http_build_query($params);

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/get-emails-clicked?'.$params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true,
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $res;

}
?>
def user_lists():
token = get_access_token()
params = {'access_token':token,
        'campaignId':1234567
}

res = requests.get('https://api.snov.io/v1/get-emails-clicked', data=params)

return json.loads(res.text)
Ejemplo de respuesta
[
    {
        "visitedAt": {
            "date": "2020-01-08 21:48:14.000000",
            "timezone_type": 3,
            "timezone": "UTC"
        },
        "campaignId": 1234567
        "campaign": "My top campaign",
        "prospectId": "a9e58c3eecff94e617815a90ca412c4c305045102be1312b41fd0073c9c9f3eee30e090bbc3e3",
        "prospectFirstName": "John",
        "prospectLastName": "Doe",
        "prospectName": "John Doe",
        "sourcePage": null,
        "source": "copy",
        "locality": null,
        "industry": null,
        "country": null,
        "prospectEmail": "Johndoe@snov.io",
        "hash": "20b1aeb0e2949fdf7e58363f84b7aff1",
        "emailSubject": "\"Special content for you\"",
        "emailBody": "\"<\p>Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.<\/p>\"",
	"skills": "",
        "links": null,
        "customFields": null,
        "id": "c2a67a47d59745f548ea7b0213c3a81d",
        "customField_Phone": ""
    }
]
Parámetros de salida
campaignId
Identificador único de la campaña.
campaign
Nombre de la campaña.
prospectName
Nombre completo del prospeccto que hizo clic en un link de un correo electrónico de la campaña.
prospectEmail
Dirección de email del prospecto.
emailSubject
Línea de asunto del correo electrónico que contenía un link cliqueado.
emailBody
Contenidos del correo electrónico.
visitedAt
La hora exacta en que el prospecto hizo clic en un link del correo electrónico.

GETVer correos electrónicos enviados

Gratis

Este método muestra la información sobre los correos electrónicos enviados en la campaña.

Solicitud
GEThttps://api.snov.io/v1/emails-sent
Parámetros de entrada
campaignId
*Requerido
Identificador único de la campaña para la que deseas ver los correos electrónicos enviados.
offset
Puedes recopilar hasta 10.000 correos electrónicos enviados por cada solicitud. Si tu campaña envió más correos electrónicos, utiliza el desplazamiento para indicar cuántos correos electrónicos anteriores quieres omitir. Por ejemplo, si tu campaña ha enviado 20.000 correos electrónicos y deseas solicitar los correos electrónicos del 10.001 al 20.000, establece el desplazamiento en 10.000. Si el desplazamiento no se especifica, recibirás los últimos 10.000 correos electrónicos que se enviaron dentro de la campaña.
Ejemplos de código
<?php
function emailsSended()
{
    $token = getAccessToken();

    $params = [
        'access_token' => $token,
        'campaignId'   => 1234567
    ];

    $params = http_build_query($params);

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/emails-sent?'.$params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true,
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $res;

}
?>
def user_lists():
token = get_access_token()
params = {'access_token':token,
        'campaignId':1234567
}

res = requests.get('https://api.snov.io/v1/emails-sent', data=params)

return json.loads(res.text)
Ejemplo de respuesta
[
    {
        "sentDate": {
            "date": "2020-07-06 06:58:10.000000",
            "timezone_type": 3,
            "timezone": "UTC"
        },
        "userName": "John Doe",
        "userEmail": "johndoe@snov.io",
        "campaign": "Test",
        "hash": "be8fd412b793c15ccab9f1a6573d6595",
        "id": "010f091d81860753a19867ba1dd805d1"
    },
    {
        "sentDate": {
            "date": "2020-07-06 06:56:44.000000",
            "timezone_type": 3,
            "timezone": "UTC"
        },
        "userName": "Mister Smith",
        "userEmail": "mistersmith@snov.io",
        "campaign": "Test",
        "hash": "55bb20def471e630c539935cb0efcbf8",
        "id": "00e3df8427477a21d64bbe959ff95471"
    }
]
Parámetros de salida
sentDate
Hora exacta en que se envió el correo electrónico.
userName
Nombre completo del prospecto al que se envió el correo electrónico.
userEmail
Dirección de email del prospecto.
campaign
Nombre de la campaña.

GETVer todas las campañas

Gratis

Este método muestra la lista de todas las campañas de los usuarios.

Solicitud
GEThttps://api.snov.io/v1/get-user-campaigns
Parámetros de entrada
No hay parámetros de entrada para este método
Ejemplos de código
<?php
function userCampaigns()
{
    $token = getAccessToken();

    $params = [
        'access_token' => $token
    ];

    $params = http_build_query($params);

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/get-user-campaigns?'.$params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true,
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $res;

}
?>
def user_lists():
token = get_access_token()

headers = {'Authorization': token}

url = 'https://api.snov.io/v1/get-user-campaigns'

response = requests.request('GET', url, headers=headers)

return json.loads(res.text)
Ejemplo de respuesta
[
    {
        "id": 237945,
        "campaign": "New Campaign",
        "list_id": 8512947,
        "status": "Paused",
        "created_at": 1639469976,
        "updated_at": 1639470026,
        "started_at": 1639470021,
        "hash": "e272be8f9a6894f5b5894fe2ef77095e"
    },
    {
        "id": 237956,
        "campaign": "Test campaign",
        "list_id": 7654321,
        "status": "Draft",
        "created_at": 1638808262,
        "updated_at": 1638808262,
        "started_at": null,
        "hash": "f97fce248b77e9a1ae770b21c7bd783d"
    }
]
Parámetros de salida
id
Identificador único de la campaña del usuario.
campaign
Nombre de la campaña.
list_id
Identificador único de la lista de prospectos utilizada en la campaña.
status
Estado de la campaña.
created_at
Fecha y hora de creación de la campaña en el formato de Unix Timestamp.
updated_at
Fecha y hora de la última actualización de la campaña en formato Unix Timestamp.
started_at
Fecha y hora de lanzamiento de la campaña en el formato de Unix Timestamp.

POSTAñadir a la lista de No enviar email

Gratis

Utilizando este método puedes añadir un correo electrónico o un dominio a tu Lista de no enviar email. Una vez que este correo electrónico/dominio se haya añadido a la lista, no podrás enviarle correos electrónicos.

Solicitud
POSThttps://api.snov.io/v1/do-not-email-list
Parámetros de entrada
items
Correo electrónico o dominio que deseas añadir a tu lista de No enviar email.
listId
*Requerido
El identificador de la Lista de No enviar emails al que pertenecen los emails y los dominios.
Ejemplos de código
<?php
function addToBlackList()
{
    $token = getAccessToken();

    $params = [
        'access_token' => $token
    ];

    $data = http_build_query([
      'items' => [
          'gavin.vanrooyen@octagon.com',
          'octagon.com'
      ]
  ]);

    $options = [
        CURLOPT_URL => 'https://api.snov.io/v1/do-not-email-list?'. $data,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => $params,
        CURLOPT_FOLLOWLOCATION => true,
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);

    curl_close($ch);
}
?>
def do_not_email_list():
    token = get_access_token()
    params = {
        'access_token':token,
        'items[]':['gavin.vanrooyen@octagon.com','octagon.com']
    }

    res = requests.post('https://api.snov.io/v1/do-not-email-list', data=params)

    return json.loads(res.text)
Ejemplo de respuesta
[
    {
        "success": true,
        "data": {
            "duplicates": []
        }
    }
]
Parámetros de salida
duplicates
Este parámetro muestra qué correos electrónicos/dominios han sido añadidos previamente a la lista de No enviar email.

POSTAñade el prospecto a la lista

Gratis

Agregar un prospecto a una lista específica. Este método será útil para aquellos que quieran automatizar la adición de prospectos a las listas con campañas activas por email. De esta manera, después de que un prospecto se agregue automáticamente a una lista elegida, se iniciará automáticamente una campaña para ellos.

Solicitud
POSThttps://api.snov.io/v1/add-prospect-to-list
Parámetros de entrada
email
*Requerido
La dirección de correo electrónico del prospecto.
fullName
El nombre completo del prospecto.
firstName
El nombre del prospecto.
lastName
El apellido del prospecto.
phones
Arreglo con números de teléfono de prospectos.
country
El país del prospecto. Los nombres de los países se definen aquí. Por favor, utiliza solo los países de esta lista.
locality
La ubicación del prospecto.
position
El cargo del prospecto.
companyName
El nombre de la empresa del prospecto.
companySite
La página web de la empresa del prospecto. Por favor, utiliza el
http://example.com
formato.
updateContact
Actualiza un prospecto existente. Puede contener
true
, o
false
. Si
true
y un prospecto con esta dirección de correo electrónico ya existe en una de las listas, el sistema actualizará el perfil existente. Si
false
, el sistema no actualizará el perfil existente.
customFields[specialization]
Puede añadir valores personalizados en campos personalizados previamente creados. Para ello, especifica el nombre del campo personalizado entre los [brackets].
socialLinks[linkedIn]
Un enlace al perfil de redes sociales del prospecto. Especifica el nombre de la red social entre [corchetes] (LinkedIn, Facebook o X).
listId
*Requerido
El identificador de la lista a la que pertenece el prospecto.
Ejemplos de código
<?php
function addProspectToList()
{
    $token = getAccessToken();

    $params = [
        'access_token'                => $token,
        'email'                       => 'john.doe@example.com',
        'fullName'                    => 'John Doe',
        'firstName'                   => 'John',
        'lastName'                    => 'Doe',
        'phones'                      => ['+18882073333', '+18882074444'],
        'country'                     => 'United States',
        'locality'                    => 'Woodbridge, New Jersey',
        'socialLinks[linkedIn]'       => 'https://www.linkedin.com/in/johndoe/&social',
        'social[twiiter]'             => 'https://twitter.com/johndoe&social',
        'customFields[specialization]'=> 'Software Engineering',
        'position'                    => 'Vice President of Sales',
        'companyName'                 => 'GoldenRule',
        'companySite'                 => 'https://goldenrule.com',
        'updateContact'               => true,
        'listId'                      => '12345',
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/add-prospect-to-list',
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);
    curl_close($ch);
    
    return $res;

}
?>
def add_prospect_to_list():
token = get_access_token()
params = {'access_token':token,
          'email':'john.doe@example.com',
          'fullName': 'John Doe',
          'firstName':'John',
          'lastName':'Doe',
          'phones':['+18882073333', '+18882074444'],
          'country':'United States',
          'locality':'Woodbridge, New Jersey',
          'socialLinks[linkedIn]':'https://www.linkedin.com/in/johndoe/&social',
          'social[twiiter]':'https://twitter.com/johndoe&social',
          'customFields[specialization]':'Software Engineering',
          'position':'Vice President of Sales',
          'companyName':'GoldenRule',
          'companySite':'https://goldenrule.com',
          'updateContact':1,
          'listId':'12345'
}

res = requests.post('https://api.snov.io/v1/add-prospect-to-list', data=params)

return json.loads(res.text)
Ejemplo de respuesta
{
    "success": true,
    "id": "0Y2QzowWL1rHpIptwaRp0Q==",
    "added": true,
    "updated": false
}
Parámetros de salida
success
Es
true
si el prospecto se ha añadido con éxito a la lista.
id
Se ha añadido el identificador de los prospectos.
added
Es
true
si el prospecto se ha añadido a la lista.
updated
Es
true
si se han actualizado los datos del prospecto existente.
errors
Ha habido un error al añadir el prospecto a la lista.

POSTEncuentra el prospect por el ID

Gratis

Encuentra prospectos de tus listas por id. Conociendo el id de un prospecto específico puedes obtener información completa sobre el mismo, incluyendo las listas y campañas a las que ha sido añadido.

Solicitud
POSThttps://api.snov.io/v1/get-prospect-by-id
Parámetros de entrada
id
*Requerido
El identificador del prospecto. Se puede ver en la respuesta cuando se añade un prospecto a través de Añade el prospecto a la lista método API o en la URL al ver la página del prospecto (ver un ejemplo).
Ejemplos de código
<?php
function getProspectById()
{
    $token = getAccessToken();

    $params = [
        'access_token'    => $token,
        'id'           => 'xusD3-T_K5IktGoaa8Jc8A=='
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/get-prospect-by-id',
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);
    curl_close($ch);
    
    return $res;

}
?>
def getProspectById():
token = get_access_token()
params = {'access_token':token,
        'id':'xusD3-T_K5IktGoaa8Jc8A=='
}

res = requests.post('https://api.snov.io/v1/get-prospect-by-id', data=params)

return json.loads(res.text)
Ejemplo de respuesta
{
  "success": true,
  "data": {
    "id": "xusD3-T_K5IktGoaa8Jc8A==",
    "name": "Gavin Vanrooyen",
    "firstName": "Gavin",
    "lastName": "Vanrooyen",
    "industry": "Entertainment",
    "country": "United States",
    "locality": "Greater Atlanta Area",
    "social": [
      {
        "link": "https:\/\/www.linkedin.com\/in\/gavin-vanrooyen-8090738\/",
        "type": "linkedIn"
      }
    ],
    "lastUpdateDate": {
      "date": "2019-09-11 12:37:58.000000",
      "timezone_type": 3,
      "timezone": "UTC"
    },
    "currentJob": [
      {
        "companyName": "Octagon",
        "position": "Senior Brand Director",
        "socialLink": "https:\/\/www.linkedin.com\/company\/659312",
        "site": "http:\/\/octagon.com",
        "locality": "United States",
        "state": null,
        "city": null,
        "street": null,
        "street2": null,
        "postal": null,
        "founded": null,
        "startDate": "2018-07-31",
        "endDate": null,
        "size": "1-10",
        "industry": "Entertainment",
        "companyType": "Public Company",
        "country": "United States"
      }
    ],
    "previousJob": [
      {
        "companyName": "UPS",
        "position": "Manager, Sponsorships and Events",
        "socialLink": "https:\/\/www.linkedin.com\/company\/152322",
        "site": "http:\/\/www.ups.com\/",
        "locality": "United States",
        "state": "GA",
        "city": "Atlanta",
        "street": "55 Glenlake Parkway, NE",
        "street2": null,
        "postal": "30328",
        "founded": "1907",
        "startDate": null,
        "endDate": null,
        "size": "10001+",
        "industry": "Logistics and Supply Chain",
        "companyType": "Public Company",
        "country": "United States"
      }
    ],
    "lists": [
      {
        "id": 1250344,
        "name": "People List"
      }
    ],
    "campaigns": []
  }
}
Parámetros de salida
success
Es
true
si se encuentra el prospecto
id
Identificador único del perfil
name
Nombre completo del prospecto
firstName
Primer nombre del prospecto
lastName
Apellido del prospecto
industry
Sector de actividad indicado en el perfil del prospecto
country
País de prospecto
locality
Ubicación de prospecto
social
Enlaces a los perfiles sociales de los prospectos
currentJobs
La matriz contiene información sobre el puesto de trabajo actual de prospecto
previousJobs
La matriz contiene información sobre los cargos anteriores del prospecto
lastUpdateDate
Fecha de la última actualización del perfil
lists
Listas a las que se ha añadido el prospecto
campaigns
Lista de campañas a las que se ha añadido este prospecto como destinatario. Contiene breves estadísticas como el estado, el número de mensajes enviados, las aperturas y las respuestas.

POSTEncuentra el prospecto por el email

Gratis

Encuentra prospectos de sus listas por dirección de correo electrónico. Cuando buscas por correo electrónico, recibes una lista de todos los prospectos vinculados a esta dirección de correo electrónico. Cada elemento de la lista contiene información completa sobre el prospecto, incluyendo las listas y las campañas a las que ha sido añadido.

Solicitud
POSThttps://api.snov.io/v1/get-prospects-by-email
Parámetros de entrada
email
*Requerido
La dirección de correo electrónico del prospecto.
Ejemplos de código
<?php
function getProspectsByEmail()
{
    $token = getAccessToken();

    $params = [
        'access_token'    => $token,
        'email'           => 'gavin.vanrooyen@octagon.com'
    ];

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/get-prospects-by-email',
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);
    curl_close($ch);
    
    return $res;

}
?>
def getProspectsByEmail():
token = get_access_token()
params = {'access_token':token,
        'email':'gavin.vanrooyen@octagon.com'
}

res = requests.post('https://api.snov.io/v1/get-prospects-by-email', data=params)

return json.loads(res.text)
Ejemplo de respuesta
{
  "success": true,
  "data": [
    {
      "id": "xusD3-T_K5IktGoaa8Jc8A==",
      "name": "Gavin Vanrooyen",
      "firstName": "Gavin",
      "lastName": "Vanrooyen",
      "industry": "Entertainment",
      "country": "United States",
      "locality": "Greater Atlanta Area",
      "social": [
        {
          "link": "https:\/\/www.linkedin.com\/in\/gavin-vanrooyen-809073755\/",
          "type": "linkedIn"
        }
      ],
      "lastUpdateDate": {
        "date": "2019-09-11 12:37:58.000000",
        "timezone_type": 3,
        "timezone": "UTC"
      },
      "currentJob": [
        {
          "companyName": "Octagon",
          "position": "Senior Brand Director",
          "socialLink": "https:\/\/www.linkedin.com\/company\/659333",
          "site": "http:\/\/octagon.com",
          "locality": "United States",
          "state": null,
          "city": null,
          "street": null,
          "street2": null,
          "postal": null,
          "founded": null,
          "startDate": "2018-07-31",
          "endDate": null,
          "size": "1-10",
          "industry": "Entertainment",
          "companyType": "Public Company",
          "country": "United States"
        }
      ],
      "previousJob": [
        {
          "companyName": "UPS",
          "position": "Manager, Sponsorships and Events",
          "socialLink": "https:\/\/www.linkedin.com\/company\/1523574",
          "site": "http:\/\/www.ups.com\/",
          "locality": "United States",
          "state": "GA",
          "city": "Atlanta",
          "street": "55 Glenlake Parkway, NE",
          "street2": null,
          "postal": "30328",
          "founded": "1907",
          "startDate": null,
          "endDate": null,
          "size": "10001+",
          "industry": "Logistics and Supply Chain",
          "companyType": "Public Company",
          "country": "United States"
        }
      ],
      "lists": [
        {
          "id": 1250344,
          "name": "People List"
        }
      ],
      "campaigns": []
    }
  ]
}
Parámetros de salida
success
Es
true
si se encuentra el prospecto
id
Identificador único del perfil
name
Nombre completo del prospecto
firstName
Nombre del prospecto
lastName
Apellido del prospecto
industry
Sector de actividad indicado en el perfil del prospecto
country
País del prospecto
locality
Ubicación del prospecto
social
Enlaces a los perfiles sociales de los prospectos
currentJobs
La matriz contiene información sobre el cargo actual del cliente potencial
previousJobs
La matriz contiene información sobre los títulos de trabajo anteriores del cliente potencial
lastUpdateDate
Fecha de la última actualización del perfil
lists
Listas a las que se ha añadido el prospecto
campaigns
Lista de campañas a las que se ha añadido este prospecto como destinatario. Contiene breves estadísticas como el estado, el número de mensajes enviados, las aperturas y las respuestas.

GETEncuentra los campos personalizados del prospecto

Gratis

Este método devuelve una lista de todos los campos personalizados creados por el usuario, incluyendo el nombre de los campos, si el campo es opcional u obligatorio, y el tipo de datos del campo.

Solicitud
GEThttps://api.snov.io/v1/prospect-custom-fields
Parámetros de entrada
No hay parámetros de entrada para este método
Ejemplos de código
<?php
function customFields()
{
    $token = getAccessToken();

    $params = [
        'access_token' => $token,
    ];

    $params = http_build_query($params);

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/prospect-custom-fields?'.$params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $res;

}
?>
def custom_fields():
token = get_access_token()
params = {'access_token':token
}

res = requests.get('https://api.snov.io/v1/prospect-custom-fields', data=params)

return json.loads(res.text)
Ejemplo de respuesta
  [
    {
        "key": "customFields['company']",
        "label": "company",
        "required": false,
        "type": "string"
    },
    {
        "key": "customFields['Project name']",
        "label": "Project name",
        "required": false,
        "type": "string"
    },
    {
        "key": "customFields['SEO']",
        "label": "SEO",
        "required": false,
        "type": "string"
    }
  ]
Parámetros de salida
key
La clave del campo en la matriz
customFields
.
label
El nombre del campo.
required
Es
true
si el campo personalizado es obligatorio.
type
El tipo de datos del campo personalizado (cadena, número o fecha).

GETVer listas de usuarios

Gratis

Este método devuelve todas las listas creadas por el usuario. Puedes utilizar este método para revisar las listas que se pueden utilizar para una campaña por email.

Solicitud
GEThttps://api.snov.io/v1/get-user-lists
Parámetros de entrada
No hay parámetros de entrada para este método
Ejemplos de código
<?php
function getUserLists()
{
    $token = getAccessToken();

    $params = [
        'access_token' => $token,
    ];

    $params = http_build_query($params);

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/get-user-lists?'.$params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $res;

}
?>
def user_lists():
token = get_access_token()
params = {'access_token':token
}

res = requests.get('https://api.snov.io/v1/get-user-lists', data=params)

return json.loads(res.text)
Ejemplo de respuesta
[
    {
        "id": 1818597,
        "name": "FirstSend",
        "contacts": 1,
        "isDeleted": false,
        "creationDate": {
            "date": "2020-04-07 08:25:44.000000",
            "timezone_type": 3,
            "timezone": "UTC"
        },
        "deletionDate": null
    },
    {
        "id": 1505383,
        "name": "All prospects",
        "contacts": 10,
        "isDeleted": true,
        "creationDate": {
            "date": "2019-12-17 15:07:30.000000",
            "timezone_type": 3,
            "timezone": "UTC"
        },
        "deletionDate": {
            "date": "2020-02-17 14:05:44.000000",
            "timezone_type": 3,
            "timezone": "UTC"
        }
    },
    {
        "id": 1479070,
        "name": "EMAIL",
        "contacts": 13,
        "isDeleted": true,
        "creationDate": {
            "date": "2019-12-06 10:51:01.000000",
            "timezone_type": 3,
            "timezone": "UTC"
        },
        "deletionDate": {
            "date": "2020-02-17 14:05:48.000000",
            "timezone_type": 3,
            "timezone": "UTC"
        }
    }
]

Parámetros de salida
id
Identificador único de la lista de usuarios.
name
Nombre de la lista
contacts
El número de prospectos en la lista.
isDeleted
Estado de la lista. Es
true
si la lista ha sido borrada.
creationDate
La fecha y la hora de creación de la lista (incluye información sobre la fecha, la hora y la zona horaria).
deleteDate
Si la lista se ha eliminado, contiene la fecha y la hora de la supresión de la lista (incluye información sobre la fecha, la hora y la zona horaria).

POSTVer prospectos en la lista

Gratis

Este método devuelve todos los datos de los prospectos en una lista específica, incluyendo los datos del prospecto como las direcciones de correo electrónico y su estado.

Solicitud
POSThttps://api.snov.io/v1/prospect-list
Parámetros de entrada
listId
*Requerido
El identificador único de la lista.
page
Puedes elegir en qué página de la lista quieres empezar tu búsqueda. Este campo es opcional.
perPage
Establece el número máximo de prospectos que se incluirán en la respuesta. El valor máximo es 5.000.
Ejemplos de código
<?php
function prospectsInList()
{
    $token = getAccessToken();

    $params = [
        'access_token' => $token,
        'listId'       => '1234567',
        'page'         => '1',
        'perPage'      => '2'
    ];

    $options = [
        CURLOPT_URL            => ' https://api.snov.io/v1/prospect-list',
        CURLOPT_POSTFIELDS     => $params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $res;

}
?>
def prospect_in_list():
token = get_access_token()
params = {'access_token':token,
        'listId':'1234567',
        'page':'1',
        'perPage':'2'
}

res = requests.post('https://api.snov.io/v1/prospect-list', params=params)

return json.loads(res.text)
Ejemplo de respuesta

Ten en cuenta que los resultados de los prospectos se muestran en orden inverso, del último al primero.

{
    "success": true,
    "list": {
        "name": "Lead LIST",
        "contacts": 3,
        "creationDate": {
            "date": "2020-05-19 17:34:39.000000",
            "timezone_type": 3,
            "timezone": "UTC"
        },
        "emailsCount": []
    },
    "prospects": [
        {
            "id": "226db935fc93422496fda5d5209e8cbf77cc77ec685891706028009b86608f7ce5877a3faf",
            "name": "Andrew Garfiled",
            "firstName": "Andrew",
            "lastName": "Garfiled",
            "emails": [
                {
                    "email": "andrewexp@exp.com",
                    "probability": 99,
                    "isVerified": null,
                    "jobStatus": "any",
                    "domainType": "linkedin_email",
                    "isValidFormat": null,
                    "isDisposable": null,
                    "isWebmail": null,
                    "isGibberish": null,
                    "smtpStatus": null
                }
            ]
        },
        {
            "id": "f20d30219b039d1408d837a748a1e2ab843c97e65080f6cf8fa7d948477d9093d87413f05f",
            "name": "John Doe",
            "firstName": "John",
            "lastName": "Doe",
            "emails": [
                {
                    "email": "johndoe@gmail.com",
                    "probability": 99,
                    "isVerified": null,
                    "jobStatus": "any",
                    "domainType": "linkedin_email",
                    "isValidFormat": true,
                    "isDisposable": false,
                    "isWebmail": true,
                    "isGibberish": false,
                    "smtpStatus": 3
                }
            ]
        }
    ]
}

Parámetros de salida
list
Una matriz con información sobre la lista y los prospectos en ella.
name
El nombre de la lista.
contacts
El número de prospectos en la lista.
creation_date
La fecha de creación de la lista (incluye la fecha, la hora y la información de la zona horaria).
emailsCount
El número de correos electrónicos de la lista.
prospects
Una lista de prospectos en la lista.
id
Un identificador único del prospecto.
name
El nombre completo de un prospecto.
emails
Una lista de correos electrónicos pertenecientes al prospecto.

POSTCrear una nueva lista de prospectos

Gratis

Utiliza este método para crear nuevas listas de prospectos en tu cuenta.

Solicitud
POSThttps://api.snov.io/v1/lists
Parámetros de entrada
name
El nombre de la nueva lista de prospectos.
Ejemplos de código
<?php
function createNewList()
{
    $token = getAccessToken();

    $params = [
        'access_token' => $token,
        'name' => 'New list'
    ];

    $options = [
        CURLOPT_URL => 'https://api.snov.io/v1/lists',
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => $params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true,
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);

    curl_close($ch);
}
?>
def add_prospect_list():
    token = get_access_token()
    params = {
        'access_token':token,
        'name':'New list'
    }

    res = requests.post('https://api.snov.io/v1/lists', data=params)

    return json.loads(res.text)
Ejemplo de respuesta
[
    {
        "success": true,
        "data": {
            "id": 1234567
        }
    }
]
Parámetros de salida
id
El ID de la lista de prospectos creada.

GETConsulta el saldo del usuario

Gratis

Utiliza este método para comprobar tu saldo de crédito.

Solicitud
GEThttps://api.snov.io/v1/get-balance
Parámetros de entrada
No hay parámetros de entrada para este método
Ejemplos de código
<?php
function getBalance()
{
    $token = getAccessToken();

    $params = [
        'access_token' => $token,
    ];

    $params = http_build_query($params);

    $options = [
        CURLOPT_URL            => 'https://api.snov.io/v1/get-balance?'.$params,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true
    ];

    $ch = curl_init();

    curl_setopt_array($ch, $options);

    $res = json_decode(curl_exec($ch), true);

    curl_close($ch);

    return $res;

}
?>
def get_balance():
token = get_access_token()
headers = {'authorization':token
}

res = requests.get('https://api.snov.io/v1/get-balance', headers=headers)

return json.loads(res.text)
Ejemplo de respuesta
{
    "success": true,
    "data": {
        "balance": "25000.00",
        "teamwork": false,
        "unique_recipients_used": 0,
        "limit_resets_in": 29,
        "expires_in": 359
    }
}

Parámetros de salida
balance
Saldo actual del usuario en créditos.
teamwork
Es verdadero si actualmente es miembro o líder de un equipo, falso si no forma parte de un equipo.
recipients_used
Número de destinatarios únicos utilizados este mes.
limit_resets_in
Días hasta el reinicio del límite.
expires_in
Días hasta el final de la suscripción.

Webhooks

Descripción

Los webhooks le permiten recibir notificaciones de eventos que sucedieron en su cuenta de Snov.io.

Puede usar webhooks para llamar al punto final (URL) en su servidor cada vez que ocurre un evento suscrito en Snov.io y enviar datos en tiempo real a su aplicación.

Cada vez que ocurre un evento, Snov.io envía una solicitud HTTP con un cuerpo JSON al punto final de URL especificado.

Puedes suscribirte y gestionar los webhooks a través de un conjunto de llamadas a la API.

Los objetos y acciones de webhook admitidos actualmente se enumeran a continuación:

Objeto de webhookAccióncuando se activa
campaign_email
sentCuando se envía cualquier email al destinatario en cualquier campaña
first_sentCuando se envía el primer email al destinatario en cualquier campaña
openedCuando un destinatario abre cualquier email de cualquier campaña
campaign_reply
receivedCuando el destinatario responde a cualquier correo electrónico de cualquiera de las campañas
first_receivedCuando el destinatario responde al correo electrónico por primera vez en cualquiera de las campañas
company
found_domains_by_namesCuando solicitas el dominio de una empresa basado en su nombre.
prospect
found_by_li_urlCuando solicitas la información del perfil de un posible cliente basada en su URL de LinkedIn.
email_verification
verifiedCuando solicitas la verificación de emails.

Límites: los usuarios del plan premium pueden crear hasta 50 webhooks.

Política de reintento: el webhook tiene éxito si recibimos un estado HTTP del rango 200-299 en respuesta dentro de los 3 segundos.

Si obtenemos cualquier otro estado HTTP o se produce un tiempo de espera, hacemos siete intentos de reintento con intervalos crecientes hasta 38 horas después del evento que dispararó un webhook:

Si todos los reintentos son infructuosos, el webhook se desactiva.

  • 1º: inmediatamente después del evento
  • 2º: 20 minutos después del último intento (20 minutos después del evento
  • 3º: 40 minutos después del último intento (1 hora después del evento)
  • 4º: 60 minutos después del último intento (2 horas después del evento)
  • 5º: 4 horas después del último intento (6 horas después del evento)
  • 6º: 8 horas después del último intento (14 horas después del evento)
  • 7º: 24 horas después del último intento (38 horas después del evento)

GETListar todos los webhooks

Este método API le permite obtener una lista de webhooks en su cuenta.
Solicitud
GEThttps://api.snov.io/v2/webhooks
Encabezado de solicitud

Content-Type: application/json

Parámetros de entrada
Este método no tiene parámetros de entrada.
Ejemplo de respuesta
{
    "data": [
        {
            "data": {
                "id": 8,
                "end_point": "https://hooks.yourdomain.com/hooks/catch/1237321/awwwcz/",
                "event_object": "campaign_email",
                "event_action": "sent",
                "status": "active",
                "created_at": 1655847444
            }
        },
        {
            "data": {
                "id": 14,
                "end_point": "https://hooks.yourdomain.com/hooks/catch/1237321/abqqqpcz/",
                "event_object": "campaign_email",
                "event_action": "sent",
                "status": "deactivated",
                "created_at": 1655890563
            }
        },
        {
            "data": {
                "id": 17,
                "end_point": "https://hooks.yourdomain.com/hooks/catch/1237321/abwfpcz/",
                "event_object": "campaign_email",
                "event_action": "sent",
                "status": "active",
                "created_at": 1656057947
            }
        }
    ],
    "meta": {
        "webhooks_count": 3,
        "user_id": 1313777
    }
}
Parámetros de salida
La respuesta devuelve una colección de modelos de webhook. Las propiedades del modelo se enumeran a continuación:
ParámetroTipo de datosTipo de datos
data
arrayColección de modelos de webhook
id
intWebhook ID
end_point
stringLa URL real que proporcionó al agregar el webhook y adónde se enviará
event_object
stringEl objeto sobre el que se realiza la acción.
event_action
stringAcción sobre el objeto
created_at
intFecha de creación del webhook en formato Unix Timestamp
status
stringEstado del webhook: activo, desactivado
meta
objectDatos relacionados
webhooks_count
intNúmero total de webhooks en su cuenta (máximo 50)
user_id
intTu identificación de usuario

POSTAgregar webhook

Este método API le permite crear una suscripción de webhook y recibir notificaciones de eventos en la URL del punto final especificado.
Solicitud
POSThttps://api.snov.io/v2/webhooks
Encabezado de solicitud

Content-Type: application/json

Parámetros de entrada
event_object
el objeto en el que se realiza la acción (lista de objetos admitidos)
event_action
la acción realizada sobre el objeto (lista de acciones admitidas)
endpoint_url
la dirección URL donde se envía el webhook
Ejemplo de solicitud
{
  "event_object": "campaign_email",
  "event_action": "sent",
  "endpoint_url": "https://hooks.yourdomain.com/hooks/catch/1237321/abwfpcz/"
}
Ejemplo de respuesta
{
    "data": {
        "id": 17,
        "end_point": "https://hooks.yourdomain.com/hooks/catch/1237321/abwfpcz/",
        "event_object": "campaign_email",
        "event_action": "sent",
        "created_at": 1656057947,
        "status": "active"
    },
    "meta": {
        "user_id": 1313777
    }
}
Parámetros de salida
La respuesta devuelve un modelo del webhook agregado. Las propiedades del modelo se enumeran a continuación:
ParámetroTipo de datosTipo de datos
data
objectdatos de webhook
id
intWebhook ID
end_point
stringLa URL real que proporcionó al agregar el webhook y adónde se enviará
event_object
stringEl objeto sobre el que se realiza la acción.
event_action
stringAcción sobre el objeto
created_at
intFecha de creación del webhook en formato Unix Timestamp
status
stringEstado del webhook: activo, desactivado
meta
objectDatos relacionados
user_id
intTu identificación de usuario

PUTCambiar el estado del webhook

Cambia el estado de una suscripción de webhook elegida.

Incluye el valor de "id" único del webhook elegido al final de la dirección URL de la solicitud.

Utiliza el método "Lista de todos los webhooks" para obtener los valores de identificación de tus webhooks.

Solicitud
PUThttps://api.snov.io/v2/webhooks/webhook_id
Encabezado de solicitud

Content-Type: application/json

Parámetros de entrada
status
Activo o desactivado
Ejemplo de solicitud
{
    https://api.snov.io/v2/webhooks/14
    "status": "deactivated"
}
Ejemplo de respuesta
{
    "data": {
        "id": 14,
        "end_point": "https://hooks.yourdomain.com/hooks/catch/1237321/abqqqpcz/",
        "event_object": "campaign_email",
        "event_action": "sent",
        "created_at": 1655890563,
        "status": "deactivated"
    },
    "meta": {
        "user_id": 1313777
    }
}
Parámetros de salida
La respuesta devuelve un modelo del webhook agregado. Las propiedades del modelo se enumeran a continuación:
ParámetroTipo de datosTipo de datos
data
objectdatos de webhook
id
intWebhook ID
end_point
stringLa URL real que proporcionó al agregar el webhook y adónde se enviará
event_object
stringEl objeto sobre el que se realiza la acción.
event_action
stringAcción sobre el objeto
created_at
intFecha de creación del webhook en formato Unix Timestamp
status
stringEstado del webhook: activo, desactivado
meta
objectDatos relacionados
user_id
intTu identificación de usuario

DELETEEliminar un webhook

Elimina un webhook elegido.

Incluye el valor de "id" único del webhook elegido al final de la dirección URL de la solicitud.

Utiliza el método "Lista de todos los webhooks" para obtener los valores de identificación de tus webhooks.

Solicitud
DELETEhttps://api.snov.io/v2/webhooks/webhook_id
Encabezado de solicitud

Content-Type: application/json

Ejemplo de solicitud
{
    https://api.snov.io/v2/webhooks/8
}
Ejemplo de respuesta
{
    "data": {
        "success": true
    }
}
Parámetros de salida
La respuesta devuelve una colección de modelos de webhook. Las propiedades del modelo se enumeran a continuación:
ParámetroTipo de datosTipo de datos
success
booleanIndica si se elimina el webhook