LinkdAPI Python SDK

LinkdAPI 的 Python SDK — 提供来自 LinkedIn 的专业个人资料与企业数据，具备企业级可靠性。

获取您的 API 密钥： https://linkdapi.com/signup?ref=K_CZJSWF

快速上手模式

对具有内联依赖的临时 Python 脚本，使用 uv script 模式：

# /// script
# dependencies = [
#     "linkdapi",
# ]
# ///

from linkdapi import LinkdAPI

client = LinkdAPI("YOUR_API_KEY")
profile = client.get_profile_overview("ryanroslansky")
print(profile)

执行命令：

uv run script.py

该命令将自动安装依赖、运行脚本并清理环境 —— 非常适合一次性任务。

为何采用此模式

• 无需全局安装：依赖按脚本独立管理
• 天生即临时：编写 → 运行 → 删除，无需额外清理
• 可复现性强：所有必要信息均包含于单个文件中
• 执行迅速：uv 负责依赖解析与缓存

编写脚本

脚本头部格式

始终以 uv script 块开头：

# /// script
# dependencies = [
#     "linkdapi",
#     # 如需其他依赖，请在此添加（例如 "rich"、"pandas"）
# ]
# ///

常见任务

获取个人资料概览：

# /// script
# dependencies = ["linkdapi"]
# ///

from linkdapi import LinkdAPI

client = LinkdAPI("YOUR_API_KEY")
profile = client.get_profile_overview("ryanroslansky")

if profile.get('success'):
    data = profile['data']
    print(f"{data['fullName']} - {data.get('headline', '')}")
    print(f"Location: {data.get('location')}")

获取公司信息：

# /// script
# dependencies = ["linkdapi"]
# ///

from linkdapi import LinkdAPI

client = LinkdAPI("YOUR_API_KEY")
company = client.get_company_info(name="google")

if company.get('success'):
    data = company['data']
    print(f"{data['name']}")
    print(f"Industry: {data.get('industry')}")
    print(f"Employees: {data.get('employeeCount', 'N/A')}")

职位搜索：

# /// script
# dependencies = ["linkdapi"]
# ///

from linkdapi import LinkdAPI

client = LinkdAPI("YOUR_API_KEY")
result = client.search_jobs(
    keyword="Software Engineer",
    location="San Francisco, CA",
    time_posted="1week"
)

if result.get('success'):
    for job in result['data']['jobs'][:5]:
        print(f"{job['title']} at {job['company']}")

批量个人资料增强（异步）：

# /// script
# dependencies = ["linkdapi"]
# ///

import asyncio
from linkdapi import AsyncLinkdAPI

async def enrich():
    async with AsyncLinkdAPI("YOUR_API_KEY") as api:
        profiles = await asyncio.gather(
            api.get_profile_overview("ryanroslansky"),
            api.get_profile_overview("satyanadella"),
            api.get_profile_overview("jeffweiner08")
        )
        for p in profiles:
            if p.get('success'):
                print(p['data']['fullName'])

asyncio.run(enrich())

Agent 工作流

当用户请求 LinkedIn 数据时：

1. 识别任务类型（如个人资料查询、公司信息、职位搜索等）
2. 在 workspace 中编写临时脚本，并包含 uv script 头部
3. 声明依赖（通常仅需 "linkdapi"，按需添加其他依赖）
4. 导入并使用 LinkdAPI 类
5. 通过 uv run 执行
6. 捕获输出结果 并反馈给用户
7. 使用后删除脚本（可选）

工作流示例

用户：“获取 jeffweiner08 的个人资料”

Agent：

cat > /tmp/linkdapi_query.py << 'EOF'
# /// script
# dependencies = ["linkdapi"]
# ///

from linkdapi import LinkdAPI
import os

client = LinkdAPI(os.getenv("LINKDAPI_API_KEY"))
profile = client.get_profile_overview("jeffweiner08")

if profile.get('success'):
    data = profile['data']
    print(f"Name: {data['fullname']}")
    print(f"Headline: {data.get('headline', 'N/A')}")
    print(f"Location: {data.get('location', 'N/A')}")
    print(f"Company: {data.get('company', 'N/A')}")
else:
    print(f"Error: {profile.get('message')}")
EOF

uv run /tmp/linkdapi_query.py
rm /tmp/linkdapi_query.py

获取 API 密钥

要使用 LinkdAPI，您需要一个 API 密钥。请前往注册：

🔗 https://linkdapi.com/signup?ref=K_CZJSWF

完成注册后，您将获得一个 API 密钥，可用于认证所有请求。

认证方式

将 API 密钥设为环境变量：

export LINKDAPI_API_KEY="your_api_key_here"

在脚本中使用：

import os
from linkdapi import LinkdAPI

client = LinkdAPI(os.getenv("LINKDAPI_API_KEY"))

核心 API 方法

个人资料

• get_profile_overview(username) — 基础个人资料信息
• get_profile_details(urn) — 详细个人资料数据
• get_contact_info(username) — 邮箱、电话、网站等联系方式
• get_full_profile(username=None, urn=None) — 完整个人资料
• get_full_experience(urn) — 工作经历
• get_education(urn) — 教育经历
• get_skills(urn) — 技能与推荐

公司

• get_company_info(company_id=None, name=None) — 公司详情
• company_name_lookup(query) — 按名称搜索公司
• get_company_employees_data(company_id) — 员工统计数据
• get_company_jobs(company_ids) — 职位列表

职位

• search_jobs(keyword, location, ...) — 搜索职位发布
• get_job_details(job_id) — 获取职位详情

搜索

• search_people(keyword, title, company, ...) — 查找人员
• search_companies(keyword, industry, ...) — 查找公司
• search_posts(keyword, ...) — 查找动态（Posts）

性能优化建议

• 批量操作请使用 AsyncLinkdAPI（速度提升约 40 倍）
• 在 asyncio.gather() 中添加 return_exceptions=True，实现容错式错误处理
• 使用上下文管理器（async with）确保资源正确释放

错误处理

检查响应并妥善处理错误：

result = client.get_profile_overview("username")

if result.get('success'):
    data = result['data']
    # 处理数据
else:
    print(f"API Error: {result.get('message')}")

参考文档

完整 API 文档地址：https://linkdapi.com/docs