API de LinkedIn: Search leads
LinkedIn lead search with Sales Navigator's search and filters: one call returns a page of up to 25 people matching a keyword and Sales Navigator lead filters (location, job title, current and past company, school, seniority, function, company size, and more), or the results of a Sales Navigator lead-search URL you built yourself. Each lead comes with name, current positions, location, summary, and photo, and its url opens the profile and can be passed to linkedin.profile for the full record. For full profiles in one call use linkedin.search_profiles.
Precios
Precios del endpoint Search leads de la API de LinkedIn
Llámalo
Obtén Search leads de LinkedIn en una sola solicitud
import os, requests res = requests.post( "https://api.getanyapi.com/v1/run/linkedin.search_leads", headers={"Authorization": f"Bearer {os.environ['ANYAPI_KEY']}"}, json={ "currentCompanies": [ "Google" ], "page": 1, "query": "engineer" }, ) print(res.json())
{
"data": {
"items": [
{
"about": "A short example description of this item.",
"currentPositions": [
{
"companyId": "Acme Inc",
"companyLinkedinUrl": "https://example.com/page",
"companyName": "Acme Inc",
"startedOn": {},
"tenureAtCompany": {},
"tenureAtPosition": {},
"title": "Example title"
}
],
"firstName": "Alex",
"id": "a1b2c3d4",
"image": "https://example.com/image.jpg",
"lastName": "Rivera",
"location": "example",
"openProfile": true,
"premium": true,
"url": "https://example.com/page"
}
],
"page": 29,
"totalPages": 12500,
"totalResults": 12500
},
"found": true,
"reason": "not_found"
}Referencia completa de parámetros y respuesta: cada campo, tipo y ejemplo de este endpoint.
Referencia
Una solicitud, un formato de respuesta.
Cada campo que envías y cada campo que recibes, cada uno con un ejemplo real.
Verificado por última vez el 2026-11-14 · disponibilidad y latencia medidas en 30d
Cuerpo de la solicitud
JSON, enviado por POST a este endpoint.
- companyHeadcountarray
Filtra por tamaño de la empresa actual (número de empleados). Códigos: A=Trabajador independiente, B=1-10, C=11-50, D=51-200, E=201-500, F=501-1,000, G=1,001-5,000, H=5,001-10,000, I=10,001+.
- companyHeadquarterLocationsarray
Filter by the location of the person's current company headquarters, by place name (e.g. ['United States']). Commas are not allowed in a value. Up to 70 values.
- currentCompaniesarray
["Google"]
Filter to people who currently work at any of these companies, by name (e.g. ['Google','Meta']). Multiple names widen the match (OR). Commas are not allowed in a value. Up to 50 values.
- excludeCompanyHeadquarterLocationsarray
Exclude people whose current company is headquartered in any of these locations. Commas are not allowed in a value. Up to 70 values.
- excludeCurrentCompaniesarray
Exclude people who currently work at any of these companies, by name. Commas are not allowed in a value. Up to 50 values.
- excludeCurrentJobTitlesarray
Exclude people whose current job title matches any of these. Commas are not allowed in a value. Up to 70 values.
- excludeFunctionIdsarray
Exclude these job functions (same codes as functionIds). Up to 30 values.
- excludeLocationsarray
Exclude people in any of these locations, by place name. Commas are not allowed in a value. Up to 70 values.
- excludePastCompaniesarray
Exclude people who previously worked at any of these companies, by name. Commas are not allowed in a value. Up to 50 values.
- excludePastJobTitlesarray
Exclude people who held any of these past job titles. Commas are not allowed in a value. Up to 70 values.
- excludeSchoolsarray
Exclude people who attended any of these schools, by name. Commas are not allowed in a value. Up to 50 values.
- excludeSeniorityLevelIdsarray
Exclude these seniority levels (same codes as seniorityLevelIds). Up to 20 values.
- firstNamesarray
Filter to people whose first name matches any of these. Commas are not allowed in a value. Up to 70 values.
- functionIdsarray
Filtra por función laboral. Códigos: 1=Contabilidad, 2=Administración, 3=Arte y diseño, 4=Desarrollo de negocios, 5=Servicios comunitarios y sociales, 6=Consultoría, 7=Educación, 8=Ingeniería, 9=Emprendimiento, 10=Finanzas, 11=Servicios de salud, 12=Recursos humanos, 13=Tecnologías de la información, 14=Legal, 15=Marketing, 16=Medios y comunicación, 17=Servicios militares y de protección, 18=Operaciones, 19=Gestión de producto, 20=Gestión de programas y proyectos, 21=Compras, 22=Control de calidad, 23=Bienes raíces, 24=Investigación, 25=Ventas, 26=Éxito y soporte al cliente.
- jobTitlestring
Optional current job title filter (e.g. 'Software Engineer'). Commas are not allowed in a value.
- lastNamesarray
Filter to people whose last name matches any of these. Commas are not allowed in a value. Up to 70 values.
- locationstring
Optional location filter (e.g. 'San Francisco'). Commas are not allowed in a value.
- pageinteger
Which page of up to 25 leads to return, starting at 1 (1-100, default 1). Also pages through a salesNavUrl search. Each page is billed as one request.
- pastCompaniesarray
Filter to people who previously worked at any of these companies, by name. Commas are not allowed in a value. Up to 50 values.
- pastJobTitlesarray
Filter by a past job title the person held (e.g. ['Product Manager']). Commas are not allowed in a value. Up to 70 values.
- profileLanguagesarray
Filtra por el idioma principal del perfil.
- querystring
engineer
Search keywords for LinkedIn leads: a role, name, or keywords (e.g. 'Marketing Manager'). Provide this or salesNavUrl.
- recentlyChangedJobsboolean
Si es true, devuelve solo personas que cambiaron de trabajo recientemente (una señal fuerte para ventas y reclutamiento).
- recentlyPostedOnLinkedInboolean
Si es true, devuelve solo personas que publicaron en LinkedIn recientemente (una señal de actividad).
- salesNavUrlstring
Alternatively, a LinkedIn Sales Navigator lead-search URL you built in Sales Navigator (e.g. https://www.linkedin.com/sales/search/people?query=(keywords%3Aengineer)). When set it overrides query and every other filter on this request; only page still applies.
- schoolsarray
Filter to people who attended any of these schools, by name. Commas are not allowed in a value. Up to 50 values.
- seniorityLevelIdsarray
Filtra por nivel jerárquico. Códigos: 100=En formación, 110=Nivel inicial, 120=Sénior, 130=Estratégico, 200=Gerente de nivel inicial, 210=Gerente con experiencia, 220=Director, 300=Vicepresidente, 310=CXO, 320=Propietario/Socio.
- yearsAtCurrentCompanyIdsarray
Filtra por antigüedad en la empresa actual. Códigos: 1=Menos de 1 año, 2=De 1 a 2 años, 3=De 3 a 5 años, 4=De 6 a 10 años, 5=Más de 10 años.
- yearsOfExperienceIdsarray
Filtra por años totales de experiencia. Códigos: 1=Menos de 1 año, 2=De 1 a 2 años, 3=De 3 a 5 años, 4=De 6 a 10 años, 5=Más de 10 años.
Respuesta
JSON, un valor de ejemplo por campo.
Matching leads, up to 25 per page. Populated whenever the provider has data for the entity.
- aboutstring
Profile summary text, when the member wrote one.
- firstNamestring
Member's first name. Populated whenever the provider has data for the entity.
- idstring
LinkedIn member id, the last segment of `url`.
- imagestring
Profile picture URL. The query string is a signed token, so keep the URL intact. Populated whenever the provider has data for the entity.
- lastNamestring
Member's last name. Populated whenever the provider has data for the entity.
- locationstring
Member's location as a single string (city, region, country). Populated whenever the provider has data for the entity.
- openProfileboolean
Whether the member accepts messages from people outside their network.
- premiumboolean
Whether the member has a LinkedIn Premium subscription.
- urlstring
LinkedIn profile URL in its member-id form (https://www.linkedin.com/in/ACwAAA...). It opens the profile on LinkedIn, and passing it as `url` to linkedin.profile returns the full record. Populated whenever the provider has data for the entity.
Current roles. Populated whenever the provider has data for the entity.
- companyIdstring
LinkedIn company id.
- companyLinkedinUrlstring
LinkedIn company page URL.
- companyNamestring
Company name.
- startedOnobject
When the role started, as `month` (1-12, when shown) and `year`.
- tenureAtCompanyobject
Time at this company, as `numYears` and `numMonths`.
- tenureAtPositionobject
Time in this role, as `numYears` and `numMonths`.
- titlestring
Job title.
The results wrapper, or null when nothing matched.
- pageinteger
The page this response holds, starting at 1.
- totalPagesinteger
How many pages of up to 25 leads the search has.
- totalResultsinteger
How many leads match the search in total, across every page.
- foundboolean
True when the page returned at least one lead.
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
Preguntas frecuentes
Acerca del endpoint Search leads de la API de LinkedIn
El endpoint Search leads de AnyAPI para LinkedIn devuelve datos de LinkedIn como JSON normalizado con una sola llamada POST a /v1/run/linkedin.search_leads. LinkedIn lead search with Sales Navigator's search and filters: one call returns a page of up to 25 people matching a keyword and Sales Navigator lead filters (location, job title, current and past company, school, seniority, function, company size, and more), or the results of a Sales Navigator lead-search URL you built yourself. Each lead comes with name, current positions, location, summary, and photo, and its url opens the profile and can be passed to linkedin.profile for the full record. For full profiles in one call use linkedin.search_profiles. AnyAPI devuelve un único esquema normalizado sin importar qué fuente atienda la solicitud. Cuesta desde US$70 por cada 1,000 solicitudes, en dólares estadounidenses, sin suscripción y sin mínimo mensual. En los últimos 30 días, el 96.0% de las llamadas al endpoint Search leads de la API de LinkedIn a través de AnyAPI tuvo éxito, con un tiempo de respuesta mediano de 4.2 segundos en 1590 llamadas medidas.