Quickstart

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 'Accept: application/json' \
  --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"
    }
  }'

import { Edges } from '@edgesrun/sdk';

const ed = new Edges({ apiKey: process.env.EDGES_API_KEY! });

const { data } = await ed.linkedin.searchPeople({
  identity_mode: "managed",
  input: {
    linkedin_people_search_url: "https://www.linkedin.com/search/results/people/?keywords=software%20engineer"
  }
});

console.log(data);

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"
  }
]

Some fields depend on which account ran the action. connection_degree describes the relationship between the profile and the LinkedIn account performing the search — so it is not returned in managed mode, where the action runs on an Edges-operated account rather than yours. Run the action with one of your own identities in direct mode if you need it.

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

Choose an Action

Browse the full action reference for LinkedIn, Sales Navigator, and data enrichment.

Pick an Identity Mode

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

Make the API call

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

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:

Mode	Setup	Cost	Best for
`managed`	None	1.5× credits	Getting started, and enrichment or search at volume
`direct`	Connect your users’ accounts	Standard	User-specific outreach, personal accounts
`auto`	Connect your users’ accounts	Standard	Spreading load across every account in your workspace

Using your own LinkedIn accounts

For production use or user-specific actions (sending messages, invitations):

Create an Identity to represent your user
Connect their LinkedIn via Chrome Extension or API
Use identity_ids: ["identity_uid"] instead of identity_mode: "managed"

Full guide: Identity Modes

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
}

Status	Meaning
`200`	Success
`400`	Bad request — check your input
`401`	Invalid or missing API key
`424`	LinkedIn-specific error (check `error_label`)
`500`	Server error — contact us

Use error_label and error_scope for programmatic error handling. See the full Error Reference.

What’s next?

Explore Actions

Browse every LinkedIn, Sales Navigator, and enrichment action

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?

Email: support@edges.run
Full API Reference: /v1/api/introduction
Troubleshooting: FAQ & Common Issues
Ask your AI tools about Edges — connect the documentation MCP, or hand your coding agent the agent skills

Agent skill

edges-getting-started — ready-made instructions for coding agents calling this endpoint.

Start here

Identities

Running actions

Limits

Troubleshooting

LinkedIn specifics

SDKs & integrations

Build with Edges

What is Edges?

Extract

Enrich

Automate

Search

Use our documentation MCP

Try it now

What you’ll get back

How it works

Identity modes explained

Handling errors

What’s next?

Explore Actions

TypeScript SDK

Async & Batch Processing

Core Concepts

Need help?

Agent skill

​What is Edges?

Extract

Enrich

Automate

Search

Use our documentation MCP

​Try it now

​What you’ll get back

​How it works

​Identity modes explained

​Handling errors

​What’s next?

Explore Actions

TypeScript SDK

Async & Batch Processing

Core Concepts

​Need help?

Agent skill

What is Edges?

Try it now

What you’ll get back

How it works

Identity modes explained

Handling errors

What’s next?

Need help?