LinkedIn Search leads API
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.
Tarifs
Tarifs de l’API LinkedIn Search leads
L’appeler
Obtenez LinkedIn Search leads en une requête
import os, requests res = requests.post( "https://api.getanyapi.com/v1/run/linkedin.search_leads", headers={"Authorization": f"Bearer {os.environ['ANYAPI_KEY']}"}, json={}, ) 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"
}Référence complète des paramètres et de la réponse : chaque champ, type et exemple de cet endpoint.
Référence
Une requête, une seule forme de réponse.
Chaque champ que vous envoyez et chaque champ que vous recevez, avec un vrai exemple.
Dernière vérification : 2026-10-07 · disponibilité et latence mesurées sur 30d
Corps de la requête
JSON, envoyé à cet endpoint.
- companyHeadcountarray
Filtre par taille actuelle de l’entreprise (nombre d’employés). Codes : A=Indépendant, 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
Filtre par fonction. Codes : 1=Comptabilité, 2=Administration, 3=Arts et design, 4=Développement commercial, 5=Communauté et services sociaux, 6=Conseil, 7=Éducation, 8=Ingénierie, 9=Entrepreneuriat, 10=Finance, 11=Services de santé, 12=Ressources humaines, 13=Informatique, 14=Juridique, 15=Marketing, 16=Médias et communication, 17=Services militaires et de protection, 18=Opérations, 19=Gestion de produit, 20=Gestion de programme et de projet, 21=Achats, 22=Assurance qualité, 23=Immobilier, 24=Recherche, 25=Ventes, 26=Réussite et support clients.
- 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
Filtre par langue principale du profil.
- querystring
engineer
Search keywords for LinkedIn leads: a role, name, or keywords (e.g. 'Marketing Manager'). Provide this or salesNavUrl.
- recentlyChangedJobsboolean
Si true, ne renvoie que les personnes qui ont récemment changé de poste (un fort signal commercial/de recrutement).
- recentlyPostedOnLinkedInboolean
Si true, ne renvoie que les personnes qui ont récemment publié sur LinkedIn (un signal d’activité).
- 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
Filtre par niveau d’ancienneté. Codes : 100=En formation, 110=Débutant, 120=Senior, 130=Stratégique, 200=Manager débutant, 210=Manager expérimenté, 220=Directeur, 300=Vice-président, 310=CXO, 320=Propriétaire/Associé.
- yearsAtCurrentCompanyIdsarray
Filtre par ancienneté dans l’entreprise actuelle. Codes : 1=Moins d’un an, 2=1 à 2 ans, 3=3 à 5 ans, 4=6 à 10 ans, 5=Plus de 10 ans.
- yearsOfExperienceIdsarray
Filtre par total d’années d’expérience. Codes : 1=Moins d’un an, 2=1 à 2 ans, 3=3 à 5 ans, 4=6 à 10 ans, 5=Plus de 10 ans.
Réponse
JSON, une valeur d’exemple par champ.
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.
FAQ
À propos de l’API LinkedIn Search leads
L’API LinkedIn Search leads d’AnyAPI renvoie des données LinkedIn en JSON normalisé à partir d’un appel POST à /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 renvoie un schéma normalisé unique quelle que soit la source qui répond. Elle coûte à partir de 70 $US pour 1 000 requêtes, en dollars US, sans abonnement et sans minimum mensuel. Ces 30 derniers jours, 99,4% des appels LinkedIn Search leads passés par AnyAPI ont réussi, avec un temps de réponse médian de 2,8 secondes, sur 172 appels mesurés.