// post /v1/bulk/linkedin
API de buscador de LinkedIn masivo
Convierta las URL del perfil de LinkedIn en datos de contacto verificados a escala mediante una operación API masiva asincrónica.
LinkedIn profile URLsHasta 20,000 filas
curl -X POST "https://api.tomba.io/v1/bulk/linkedin" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"LinkedIn Finder job","list":"https://www.linkedin.com/in/richard-hendricks","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'const res = await fetch("https://api.tomba.io/v1/bulk/linkedin", {
method: "POST",
headers: {
"X-Tomba-Key": process.env.TOMBA_API_KEY,
"X-Tomba-Secret": process.env.TOMBA_SECRET_KEY,
"Content-Type": "application/json"
},
body: JSON.stringify({
"name": "LinkedIn Finder job",
"list": "https://www.linkedin.com/in/richard-hendricks",
"launch": true,
"webhook_url": "https://hooks.example.com/tomba"
})
});
const { data } = await res.json(); // { id }import os, requests
res = requests.post(
"https://api.tomba.io/v1/bulk/linkedin",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "LinkedIn Finder job",
"list": "https://www.linkedin.com/in/richard-hendricks",
"launch": True,
"webhook_url": "https://hooks.example.com/tomba"
},
)
job_id = res.json()["data"]["id"]// 01 · solicitud
LinkedIn Finder masivo es una solicitud HTTPS
Envía los parámetros con tu clave y tu secreto. Cada SDK, la CLI y el servidor MCP hacen esta misma llamada.
- type
- list | data | file
- LinkedIn profile URLs
- launch
- true inicia el trabajo de inmediato
- webhook_url
- Recibe un evento firmado cuando termina el trabajo
- rows
- Hasta 20,000 por trabajo
curl -X POST "https://api.tomba.io/v1/bulk/linkedin" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"LinkedIn Finder job","list":"https://www.linkedin.com/in/richard-hendricks","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'const res = await fetch("https://api.tomba.io/v1/bulk/linkedin", {
method: "POST",
headers: {
"X-Tomba-Key": process.env.TOMBA_API_KEY,
"X-Tomba-Secret": process.env.TOMBA_SECRET_KEY,
"Content-Type": "application/json"
},
body: JSON.stringify({
"name": "LinkedIn Finder job",
"list": "https://www.linkedin.com/in/richard-hendricks",
"launch": true,
"webhook_url": "https://hooks.example.com/tomba"
})
});
const { data } = await res.json(); // { id }import os, requests
res = requests.post(
"https://api.tomba.io/v1/bulk/linkedin",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "LinkedIn Finder job",
"list": "https://www.linkedin.com/in/richard-hendricks",
"launch": True,
"webhook_url": "https://hooks.example.com/tomba"
},
)
job_id = res.json()["data"]["id"]// 02 · respuesta
Lo que recibes
JSON, igual en todos los lenguajes. Los campos que Tomba no conoce son null, nunca se adivinan.
GET
/linkedinCampodataobject | array- The person; an array of every match when you send full=true
data.emailstring | null- The address, or null when none is found
data.scoreinteger- Confidence from 0 to 100
data.verification.statusstring | null- valid, accept_all, invalid or unknown, with verification.date
data.full_name, data.position, data.departmentstring | null- Name, job title and team
data.typestring | null- personal or generic (a role address such as sales@)
data.linkedin, data.twitterstring | null- Public profiles
data.sources[]array | null- Up to 20 public pages where the address was found, with dates
data.accept_allboolean | null- The domain accepts mail for any address (catch-all)
data.phone_numberboolean- Tomba holds a phone number for the person
data.phone_data[]array- The numbers, when you send enrich_mobile (each as in Phone Finder)
POST /bulk/linkedin
201 Created
{
"data": {
"id": 1042
}
}Cada fila, tal como la devuelve GET /linkedin
200 OK
{
"data": {
"email": "richard@piedpiper.com",
"first_name": "Richard",
"last_name": "Hendricks",
"full_name": "Richard Hendricks",
"website_url": "piedpiper.com",
"company": "Pied Piper",
"pattern": "{first}",
"department": "executive",
"type": "personal",
"position": "CEO",
"country": "US",
"gender": "male",
"twitter": null,
"linkedin": "https://www.linkedin.com/in/richard-hendricks",
"score": 100,
"accept_all": false,
"phone_number": true,
"verification": {
"date": "2025-01-15T10:32:00+01:00",
"status": "valid"
},
"sources": [
{
"uri": "https://piedpiper.com/blog/engineering",
"website_url": "piedpiper.com",
"extracted_on": "2024-06-01T09:14:07+01:00",
"last_seen_on": "2025-01-10T17:02:44+01:00",
"still_on_page": true
}
],
"phone_data": []
}
}// 03 · coste y límites
Lo que cuesta una llamada
Una llamada solo se cobra en la condición indicada abajo. Los límites de solicitudes dependen de tu plan.
// coste
1 search credit per row with a result. Plus 5 per row with phone data.
Charged once, at the first download; later downloads are free
- Jobs created: 15 per day for each type
- Running jobs: 2 per type
- Downloads: 25 per day for each job
- Request size: 4 MB (CSV, list or rows)
Cree una operación masiva cargando las URL del perfil de LinkedIn y luego inicie la operación. La API encuentra direcciones de correo electrónico profesionales para cada perfil de forma asincrónica.
Puede procesar hasta 10.000 URL de perfiles de LinkedIn por operación masiva. Para conjuntos de datos más grandes, cree varias operaciones masivas.
La API admite URL de perfil de LinkedIn estándar (linkedin.com/in/username). Se aceptan URL http y https con o sin barras diagonales.
Cada resultado incluye la dirección de correo electrónico, el nombre completo, la empresa, el puesto, la URL de LinkedIn, el número de teléfono (si está disponible), la puntuación de confianza y el estado de verificación.
El tiempo de procesamiento depende del tamaño de la lista y de las búsquedas que requiera. Consulte el estado del trabajo o configure un webhook para saber cuándo termina.
Cada perfil de LinkedIn que devuelve un correo electrónico cuenta como 1 solicitud. Los perfiles en los que no se encuentra ningún correo electrónico no cuentan para su cuota.
Tomba utiliza información disponible públicamente y no rastrea LinkedIn directamente. Los correos electrónicos se encuentran en nuestra base de datos patentada de contactos profesionales.
Sí, configure una URL de webhook para recibir una notificación cuando su operación de buscador masivo de LinkedIn se complete con los resultados listos para descargar.
Sí. Los equipos suelen ejecutar LinkedIn Finder primero y luego pasar los correos electrónicos coincidentes a Bulk Email Enrichment y Bulk Email Verifier para obtener un contexto y una validación más profundos.
Utilice URL canónicas completas del perfil de LinkedIn, elimine duplicados y evite páginas de empresa o URL de publicación para maximizar las coincidencias exitosas.