API para 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.
Preços
Preços do endpoint Search leads da API para LinkedIn
Como chamar
Obtenha Search leads do LinkedIn em uma só requisição
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"
}Referência completa de parâmetros e resposta - todos os campos, tipos e exemplos deste endpoint.
Referência
Uma requisição, um formato de resposta.
Cada campo que você envia e cada campo que você recebe, cada um com um exemplo real.
Última verificação em 2026-11-20 · disponibilidade e latência medidas em 30d
Corpo da requisição
JSON, enviado via POST para este endpoint.
- companyHeadcountarray
Filtra pelo porte da empresa atual (número de funcionários). Códigos: A=Autônomo, 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 função. Códigos: 1=Contabilidade, 2=Administrativo, 3=Artes e design, 4=Desenvolvimento de negócios, 5=Serviços comunitários e sociais, 6=Consultoria, 7=Educação, 8=Engenharia, 9=Empreendedorismo, 10=Finanças, 11=Serviços de saúde, 12=Recursos humanos, 13=Tecnologia da informação, 14=Jurídico, 15=Marketing, 16=Mídia e comunicação, 17=Serviços militares e de proteção, 18=Operações, 19=Gestão de produto, 20=Gestão de programas e projetos, 21=Compras, 22=Garantia de qualidade, 23=Imobiliário, 24=Pesquisa, 25=Vendas, 26=Sucesso e suporte ao 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 pelo idioma principal do perfil.
- querystring
engineer
Search keywords for LinkedIn leads: a role, name, or keywords (e.g. 'Marketing Manager'). Provide this or salesNavUrl.
- recentlyChangedJobsboolean
Quando true, retorna só pessoas que mudaram de emprego recentemente (um sinal forte para vendas/recrutamento).
- recentlyPostedOnLinkedInboolean
Quando true, retorna só pessoas que publicaram no LinkedIn recentemente (um sinal de atividade).
- 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 nível de senioridade. Códigos: 100=Em treinamento, 110=Nível de entrada, 120=Sênior, 130=Estratégico, 200=Gerente iniciante, 210=Gerente experiente, 220=Diretor, 300=Vice-presidente, 310=CXO, 320=Proprietário/Sócio.
- yearsAtCurrentCompanyIdsarray
Filtra pelo tempo na empresa atual. Códigos: 1=Menos de 1 ano, 2=1 a 2 anos, 3=3 a 5 anos, 4=6 a 10 anos, 5=Mais de 10 anos.
- yearsOfExperienceIdsarray
Filtra pelo total de anos de experiência. Códigos: 1=Menos de 1 ano, 2=1 a 2 anos, 3=3 a 5 anos, 4=6 a 10 anos, 5=Mais de 10 anos.
Resposta
JSON, um valor de exemplo 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.
Dúvidas frequentes
Sobre o endpoint Search leads da API para LinkedIn
O endpoint Search leads da AnyAPI para LinkedIn retorna dados de LinkedIn em JSON normalizado com uma chamada POST para /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. A AnyAPI retorna um schema normalizado, seja qual for a fonte que atende. Custa a partir de US$ 70 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 96,1% das chamadas ao endpoint Search leads da API para LinkedIn feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 4,0 segundos, em 1.931 chamadas medidas.