Skip to main content

​
What is Edges?

Edges is the API for LinkedIn automation and data enrichment. One API call to:

Extract

Profiles, posts, companies

Enrich

Add LinkedIn data to your SaaS or agent

Automate

Messages, invites, follows

Search

Find leads at scale
No LinkedIn account setup required — start with identity_mode: "managed" and upgrade later.

Use our documentation MCP

Add Edges Documentation to your AI assistant or IDE thanks to our Model Context Protocol server. Best advices directly from the documentation into your IDE !

​
Try it now

Get your API key from Developer Settings, then run: 
curl --request POST \
  --url https://api.edges.run/v1/actions/linkedin-search-people/run/live \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --data '{
    "identity_mode": "managed",
    "input": {
      "linkedin_people_search_url": "https://www.linkedin.com/search/results/people/?keywords=software%20engineer"
    }
  }'
Success! If you see an array of LinkedIn profiles, you’re ready to build.

​
What you’ll get back

[
  {
    "full_name": "John Doe",
    "linkedin_profile_url": "https://www.linkedin.com/in/johndoe",
    "job_title": "Senior Software Engineer",
    "company_name": "Tech Company",
    "headline": "Software Engineer | Full Stack Developer",
    "location": "San Francisco Bay Area",
    "connection_degree": "2nd"
  }
]
Managed mode cost: Using identity_mode: "managed" costs 1.5× standard credits but requires zero setup. Perfect for getting started.
Built-in protection: Edges applies Smart Limits to protect LinkedIn accounts from restrictions automatically. Learn more.

​
How it works

1

Choose an Action

Browse 60+ Actions for LinkedIn, Sales Navigator, and data enrichment.
2

Pick an Identity Mode

Use managed (no setup), your users’ accounts (direct), or rotate your accounts (auto).
3

Make the API call

Send a POST request with your input. Results return in real-time.
4

Process results

Each successful result consumes credits — see how billing works.

​
Identity modes explained

Most Actions require a LinkedIn account to execute. Edges gives you three options:
ModeSetupCostBest for
managedNone1.5× creditsGetting started, testing, hassle-free automation
directConnect your users’ accountsStandardUser-specific outreach, personal accounts
autoRent accounts from Edges$70-125/mo + standardHigh-volume, dedicated bandwidth
For production use or user-specific actions (sending messages, invitations):
  1. Create an Identity to represent your user
  2. Connect their LinkedIn via Chrome Extension or API
  3. Use identity_ids: ["identity_uid"] instead of identity_mode: "managed"
Full guide: LinkedIn Identity Options

​
Handling errors

The API uses consistent error responses across all endpoints: 
{
  "error_label": "INVALID_INPUT",
  "error_scope": "input",
  "error_ref": "ERR-12345",
  "message": "The provided input is invalid.",
  "status_code": 400
}
StatusMeaning
200Success
400Bad request — check your input
401Invalid or missing API key
424LinkedIn-specific error (check error_label)
500Server error — contact us
Use error_label and error_scope for programmatic error handling. See the full Error Reference.

​
What’s next?

Explore Actions

Browse 60+ LinkedIn, Sales Navigator, and enrichment actions

TypeScript SDK

Type-safe SDK with autocomplete for faster development

Async & Batch Processing

Process thousands of records with callbacks

Core Concepts

Deep dive into Identities, Integrations, and Runs

​
Need help?