LinkdAPI Python SDK

Python SDK for LinkdAPI — professional profile and company data from LinkedIn with enterprise-grade reliability.

Get your API key: https://linkdapi.com/signup?ref=K_CZJSWF

Quick Start Pattern

Use the uv script pattern for ephemeral Python scripts with inline dependencies:

# /// script
# dependencies = [
#     "linkdapi",
# ]
# ///
from linkdapi import LinkdAPI
client = LinkdAPI("YOUR_API_KEY")
profile = client.get_profile_overview("ryanroslansky")
print(profile)

Run with:

uv run script.py

This installs dependencies automatically, runs the script, and cleans up — perfect for one-off tasks.

Why This Pattern

No global installs: Dependencies are managed per-script
Ephemeral by design: Write, run, delete — no cleanup needed
Reproducible: Everything needed is in one file
Fast: uv handles dependency resolution and caching

Writing Scripts

Script Header Format

Always start with the uv script block:

# /// script
# dependencies = [
#     "linkdapi",
#     # Add more if needed (e.g., "rich", "pandas")
# ]
# ///

Common Tasks

Get profile overview:

# /// 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')}")

Get company info:

# /// 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')}")

Search jobs:

# /// 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']}")

Batch profile enrichment (async):

# /// 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 Workflow

When a user requests LinkedIn data:

Identify the task (profile lookup, company data, job search, etc.)
Write a temporary script in workspace with the uv script header
Add dependencies (usually just
```
"linkdapi"
```
, add others if needed)
Import and use LinkdAPI classes
Run with
uv run
Capture output and report to user
Delete the script after use (optional)

Example Workflow

User: "Get the profile for 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

Getting an API Key

To use LinkdAPI, you'll need an API key. Sign up at:

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

Once registered, you'll get an API key that you can use to authenticate your requests.

Authentication

Set the API key as an environment variable:

export LINKDAPI_API_KEY="your_api_key_here"

Use it in scripts:

import os
from linkdapi import LinkdAPI
client = LinkdAPI(os.getenv("LINKDAPI_API_KEY"))

Key API Methods

Profiles

```
get_profile_overview(username)
```
— Basic profile info
```
get_profile_details(urn)
```
— Detailed profile data
```
get_contact_info(username)
```
— Email, phone, websites

get_full_profile(username=None, urn=None)

— Complete profile

```
get_full_experience(urn)
```
— Work history
```
get_education(urn)
```
— Education history
```
get_skills(urn)
```
— Skills & endorsements

Companies

get_company_info(company_id=None, name=None)

— Company details

```
company_name_lookup(query)
```
— Search by name
```
get_company_employees_data(company_id)
```
— Employee stats
```
get_company_jobs(company_ids)
```
— Job listings

Jobs

```
search_jobs(keyword, location, ...)
```
— Search job postings
```
get_job_details(job_id)
```
— Detailed job info

Search

search_people(keyword, title, company, ...)

— Find people

search_companies(keyword, industry, ...)

— Find companies

```
search_posts(keyword, ...)
```
— Find posts

Performance Tips

Use
```
AsyncLinkdAPI
```
for batch operations (40x faster)
Add
```
return_exceptions=True
```
in
```
asyncio.gather()
```
for graceful error handling
Use context managers (
```
async with
```
) for proper resource cleanup

Error Handling

Check responses and handle errors:

result = client.get_profile_overview("username")
if result.get('success'):
data = result['data']
# Process data
else:
print(f"API Error: {result.get('message')}")

References

Full API documentation: https://linkdapi.com/docs

Linkedin API

AI Skill Market Insights

Be Part of the 2,074+ Developer Community

LinkdAPI Python SDK

Quick Start Pattern

Why This Pattern

Writing Scripts

Script Header Format

Common Tasks

Agent Workflow

Example Workflow

Getting an API Key

Authentication

Key API Methods

Profiles

Companies

Jobs

Search

Performance Tips

Error Handling

References

Quick Start

Manual Installation

TEAR & SHARE

Tags

Financial Analyst

Social Media Marketing

Xpoz Setup

lead-generating

stock-analysis-lianghua

Channels

Learn

Compare

Company