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.
价格
LinkedIn Search leads API 价格
调用方式
一个请求获取 LinkedIn Search leads
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"
}完整的参数与响应参考:这个接口的每个字段、类型和示例。
参考
一个请求,一种响应结构。
你发送的每个字段和收到的每个字段,都附有真实示例。
最近验证于 2026-11-14 · 可用率和延迟按 30d 统计
请求体
JSON,POST 到这个接口。
- companyHeadcountarray
按当前公司规模(员工人数)筛选。代码:A=自雇,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
按职能筛选。代码:1=会计,2=行政,3=艺术与设计,4=业务拓展,5=社区与社会服务,6=咨询,7=教育,8=工程,9=创业,10=财务,11=医疗服务,12=人力资源,13=信息技术,14=法务,15=市场营销,16=媒体与传播,17=军事与安保服务,18=运营,19=产品管理,20=项目与计划管理,21=采购,22=质量保证,23=房地产,24=研究,25=销售,26=客户成功与支持。
- 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
按主页的主要语言筛选。
- querystring
engineer
Search keywords for LinkedIn leads: a role, name, or keywords (e.g. 'Marketing Manager'). Provide this or salesNavUrl.
- recentlyChangedJobsboolean
为 true 时,只返回最近换过工作的人员(强烈的销售/招聘信号)。
- recentlyPostedOnLinkedInboolean
为 true 时,只返回最近在 LinkedIn 上发过帖子的人员(活跃度信号)。
- 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
按职级筛选。代码:100=培训中,110=入门级,120=资深,130=战略级,200=初级经理,210=资深经理,220=总监,300=副总裁,310=CXO,320=所有者/合伙人。
- yearsAtCurrentCompanyIdsarray
按在当前公司的任职时长筛选。代码:1=不到 1 年,2=1 到 2 年,3=3 到 5 年,4=6 到 10 年,5=超过 10 年。
- yearsOfExperienceIdsarray
按总工作年限筛选。代码:1=不到 1 年,2=1 到 2 年,3=3 到 5 年,4=6 到 10 年,5=超过 10 年。
响应
JSON,每个字段一个示例值。
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.
常见问题
关于 LinkedIn Search leads API
AnyAPI 的 LinkedIn Search leads API 只需一次 POST 请求 /v1/run/linkedin.search_leads,就以统一格式的 JSON 返回 LinkedIn 数据。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 都返回同一套统一的 schema。费用:每千次请求 US$70 起,以美元计价,无需订阅,也没有每月最低消费。过去 30 天,通过 AnyAPI 发起的 LinkedIn Search leads API 调用中有 96.0% 成功,响应时间中位数为 4.2 秒,共测量 1,590 次调用。