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.

​
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?