Run linkedin-page-followers-enrich flow asynchronously
curl --request POST \
--url https://api.edges.run/v1/flows/linkedin-page-followers-enrich/run/async \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"inputs": [
{
"linkedin_company_url": "<string>",
"custom_data": {
"meta": "<unknown>"
}
}
],
"steps": [],
"parameters": {
"linkedin-extract-page-followers": {},
"linkedin-extract-people": {},
"linkedin-extract-company": {},
"fullenrich-enrich-people": {}
},
"identity_ids": [
"44444444-4444-4444-4444-444444444444"
],
"identity_mode": "direct"
}
'import requests
url = "https://api.edges.run/v1/flows/linkedin-page-followers-enrich/run/async"
payload = {
"inputs": [
{
"linkedin_company_url": "<string>",
"custom_data": { "meta": "<unknown>" }
}
],
"steps": [],
"parameters": {
"linkedin-extract-page-followers": {},
"linkedin-extract-people": {},
"linkedin-extract-company": {},
"fullenrich-enrich-people": {}
},
"identity_ids": ["44444444-4444-4444-4444-444444444444"],
"identity_mode": "direct"
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
inputs: [{linkedin_company_url: '<string>', custom_data: {meta: '<unknown>'}}],
steps: [],
parameters: {
'linkedin-extract-page-followers': {},
'linkedin-extract-people': {},
'linkedin-extract-company': {},
'fullenrich-enrich-people': {}
},
identity_ids: ['44444444-4444-4444-4444-444444444444'],
identity_mode: 'direct'
})
};
fetch('https://api.edges.run/v1/flows/linkedin-page-followers-enrich/run/async', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.edges.run/v1/flows/linkedin-page-followers-enrich/run/async",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'inputs' => [
[
'linkedin_company_url' => '<string>',
'custom_data' => [
'meta' => '<unknown>'
]
]
],
'steps' => [
],
'parameters' => [
'linkedin-extract-page-followers' => [
],
'linkedin-extract-people' => [
],
'linkedin-extract-company' => [
],
'fullenrich-enrich-people' => [
]
],
'identity_ids' => [
'44444444-4444-4444-4444-444444444444'
],
'identity_mode' => 'direct'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.edges.run/v1/flows/linkedin-page-followers-enrich/run/async"
payload := strings.NewReader("{\n \"inputs\": [\n {\n \"linkedin_company_url\": \"<string>\",\n \"custom_data\": {\n \"meta\": \"<unknown>\"\n }\n }\n ],\n \"steps\": [],\n \"parameters\": {\n \"linkedin-extract-page-followers\": {},\n \"linkedin-extract-people\": {},\n \"linkedin-extract-company\": {},\n \"fullenrich-enrich-people\": {}\n },\n \"identity_ids\": [\n \"44444444-4444-4444-4444-444444444444\"\n ],\n \"identity_mode\": \"direct\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.edges.run/v1/flows/linkedin-page-followers-enrich/run/async")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"inputs\": [\n {\n \"linkedin_company_url\": \"<string>\",\n \"custom_data\": {\n \"meta\": \"<unknown>\"\n }\n }\n ],\n \"steps\": [],\n \"parameters\": {\n \"linkedin-extract-page-followers\": {},\n \"linkedin-extract-people\": {},\n \"linkedin-extract-company\": {},\n \"fullenrich-enrich-people\": {}\n },\n \"identity_ids\": [\n \"44444444-4444-4444-4444-444444444444\"\n ],\n \"identity_mode\": \"direct\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.edges.run/v1/flows/linkedin-page-followers-enrich/run/async")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"inputs\": [\n {\n \"linkedin_company_url\": \"<string>\",\n \"custom_data\": {\n \"meta\": \"<unknown>\"\n }\n }\n ],\n \"steps\": [],\n \"parameters\": {\n \"linkedin-extract-page-followers\": {},\n \"linkedin-extract-people\": {},\n \"linkedin-extract-company\": {},\n \"fullenrich-enrich-people\": {}\n },\n \"identity_ids\": [\n \"44444444-4444-4444-4444-444444444444\"\n ],\n \"identity_mode\": \"direct\"\n}"
response = http.request(request)
puts response.read_body{
"uid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"workflow": {
"uid": "<string>",
"metadata": {
"account_rotation": true
}
}
}{
"error_label": "<string>",
"error_scope": "input",
"error_ref": "ERR-12345",
"message": "<string>",
"status_code": 123,
"params": {},
"data": {}
}{
"error_label": "<string>",
"error_scope": "input",
"error_ref": "ERR-12345",
"message": "<string>",
"status_code": 123,
"params": {},
"data": {}
}{
"error_label": "<string>",
"error_scope": "input",
"error_ref": "ERR-12345",
"message": "<string>",
"status_code": 123,
"params": {},
"data": {}
}Flows Presets
LinkedIn Page Followers Enrich
Extract followers of a LinkedIn company page and enrich them with additional data
POST
/
flows
/
linkedin-page-followers-enrich
/
run
/
async
Run linkedin-page-followers-enrich flow asynchronously
curl --request POST \
--url https://api.edges.run/v1/flows/linkedin-page-followers-enrich/run/async \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"inputs": [
{
"linkedin_company_url": "<string>",
"custom_data": {
"meta": "<unknown>"
}
}
],
"steps": [],
"parameters": {
"linkedin-extract-page-followers": {},
"linkedin-extract-people": {},
"linkedin-extract-company": {},
"fullenrich-enrich-people": {}
},
"identity_ids": [
"44444444-4444-4444-4444-444444444444"
],
"identity_mode": "direct"
}
'import requests
url = "https://api.edges.run/v1/flows/linkedin-page-followers-enrich/run/async"
payload = {
"inputs": [
{
"linkedin_company_url": "<string>",
"custom_data": { "meta": "<unknown>" }
}
],
"steps": [],
"parameters": {
"linkedin-extract-page-followers": {},
"linkedin-extract-people": {},
"linkedin-extract-company": {},
"fullenrich-enrich-people": {}
},
"identity_ids": ["44444444-4444-4444-4444-444444444444"],
"identity_mode": "direct"
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
inputs: [{linkedin_company_url: '<string>', custom_data: {meta: '<unknown>'}}],
steps: [],
parameters: {
'linkedin-extract-page-followers': {},
'linkedin-extract-people': {},
'linkedin-extract-company': {},
'fullenrich-enrich-people': {}
},
identity_ids: ['44444444-4444-4444-4444-444444444444'],
identity_mode: 'direct'
})
};
fetch('https://api.edges.run/v1/flows/linkedin-page-followers-enrich/run/async', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.edges.run/v1/flows/linkedin-page-followers-enrich/run/async",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'inputs' => [
[
'linkedin_company_url' => '<string>',
'custom_data' => [
'meta' => '<unknown>'
]
]
],
'steps' => [
],
'parameters' => [
'linkedin-extract-page-followers' => [
],
'linkedin-extract-people' => [
],
'linkedin-extract-company' => [
],
'fullenrich-enrich-people' => [
]
],
'identity_ids' => [
'44444444-4444-4444-4444-444444444444'
],
'identity_mode' => 'direct'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.edges.run/v1/flows/linkedin-page-followers-enrich/run/async"
payload := strings.NewReader("{\n \"inputs\": [\n {\n \"linkedin_company_url\": \"<string>\",\n \"custom_data\": {\n \"meta\": \"<unknown>\"\n }\n }\n ],\n \"steps\": [],\n \"parameters\": {\n \"linkedin-extract-page-followers\": {},\n \"linkedin-extract-people\": {},\n \"linkedin-extract-company\": {},\n \"fullenrich-enrich-people\": {}\n },\n \"identity_ids\": [\n \"44444444-4444-4444-4444-444444444444\"\n ],\n \"identity_mode\": \"direct\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.edges.run/v1/flows/linkedin-page-followers-enrich/run/async")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"inputs\": [\n {\n \"linkedin_company_url\": \"<string>\",\n \"custom_data\": {\n \"meta\": \"<unknown>\"\n }\n }\n ],\n \"steps\": [],\n \"parameters\": {\n \"linkedin-extract-page-followers\": {},\n \"linkedin-extract-people\": {},\n \"linkedin-extract-company\": {},\n \"fullenrich-enrich-people\": {}\n },\n \"identity_ids\": [\n \"44444444-4444-4444-4444-444444444444\"\n ],\n \"identity_mode\": \"direct\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.edges.run/v1/flows/linkedin-page-followers-enrich/run/async")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"inputs\": [\n {\n \"linkedin_company_url\": \"<string>\",\n \"custom_data\": {\n \"meta\": \"<unknown>\"\n }\n }\n ],\n \"steps\": [],\n \"parameters\": {\n \"linkedin-extract-page-followers\": {},\n \"linkedin-extract-people\": {},\n \"linkedin-extract-company\": {},\n \"fullenrich-enrich-people\": {}\n },\n \"identity_ids\": [\n \"44444444-4444-4444-4444-444444444444\"\n ],\n \"identity_mode\": \"direct\"\n}"
response = http.request(request)
puts response.read_body{
"uid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"workflow": {
"uid": "<string>",
"metadata": {
"account_rotation": true
}
}
}{
"error_label": "<string>",
"error_scope": "input",
"error_ref": "ERR-12345",
"message": "<string>",
"status_code": 123,
"params": {},
"data": {}
}{
"error_label": "<string>",
"error_scope": "input",
"error_ref": "ERR-12345",
"message": "<string>",
"status_code": 123,
"params": {},
"data": {}
}{
"error_label": "<string>",
"error_scope": "input",
"error_ref": "ERR-12345",
"message": "<string>",
"status_code": 123,
"params": {},
"data": {}
}The LinkedIn Page Followers Enrich flow extracts all followers of a LinkedIn company page, then optionally enriches them with profile and contact information. This flow is ideal for audience analysis and lead generation from company page followers.
Examples:
Flow Steps
The flow executes steps in the following order:- Extract Page Followers (required): Extracts all followers of the specified LinkedIn company page
-
Optional enrichment steps (can include any combination)
linkedin-extract-people: Extracts detailed LinkedIn profile information (sections, experiences, skills, highlights)linkedin-extract-company: Extracts company information for each profile’s current companyfullenrich-enrich-people: Enriches profiles with contact information (emails and/or phone numbers). Credit costs: 2 credits for emails, 20 credits for phones, 22 credits for both.
Some steps have dependencies on other steps. For example,
fullenrich-enrich-people requires profile data from previous steps. If you include a step that has dependencies, the required steps will be automatically activated even if you don’t explicitly include them in your request body.Custom Data
Custom Data
Each item in the
inputs array can include an optional custom_data object. The only valid key inside custom_data is meta. Use meta to attach a free-form object (e.g. your own IDs, tags, or context) that will be passed through and available in the flow output.Example:"inputs": [
{
...
"custom_data": {
"meta": {
"foo": "bar",
"crm_id": 1234
}
}
}
]
We currently require
meta as a workaround to ship this capability; a more solid implementation will follow soon without breaking changes.Basic followers extraction
Basic followers extraction
curl --request POST \
--url https://api.edges.run/v1/flows/linkedin-page-followers-enrich/run/async \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <your-api-key>' \
--data '{
"inputs": [
{
"linkedin_company_url": "https://www.linkedin.com/company/example"
}
],
"identity_mode": "managed"
}'
Full enrichment with pagination
Full enrichment with pagination
curl --request POST \
--url https://api.edges.run/v1/flows/linkedin-page-followers-enrich/run/async \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <your-api-key>' \
--data '{
"steps": [
"Extract LinkedIn People Profile",
"Extract LinkedIn Company Profile",
"Full enrich people"
],
"parameters": {
"linkedin-extract-page-followers": {
"max_results": 1000,
"skip_pages": 0
},
"linkedin-extract-people": {
"sections": true,
"experiences": true,
"skills": true,
"highlights": true
},
"fullenrich-enrich-people": {
"enrich_level": "emails_and_phones"
}
},
"inputs": [
{
"linkedin_company_url": "https://www.linkedin.com/company/example"
}
],
"identity_ids": ["44444444-4444-4444-4444-444444444444"]
}'
With webhook callback
With webhook callback
curl --request POST \
--url https://api.edges.run/v1/flows/linkedin-page-followers-enrich/run/async \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <your-api-key>' \
--data '{
"inputs": [
{
"linkedin_company_url": "https://www.linkedin.com/company/example"
}
],
"identity_mode": "managed",
"callback": {
"url": "https://your-app.com/webhook/flow-results",
"headers": {
"Authorization": "Bearer your-webhook-token"
}
}
}'
Instead of polling for results, you can use webhooks to receive automatic notifications when this flow completes. Learn more about webhook payloads and handling.
Authorizations
Body
application/json
Required array length:
1 - 1000 elements- Option 1
- Option 2
Show child attributes
Show child attributes
Optional list of step to run. If not provided, only the required steps will be run.
Available options:
linkedin-extract-people, linkedin-extract-company, fullenrich-enrich-people Show child attributes
Show child attributes
An array of Identity UUIDs linked to identities (e.g. LinkedIn) used to execute the Action. You must provide at least one valid UID with access to the integration. Do not use account_uid values — only user_uid is supported.
Example:
["44444444-4444-4444-4444-444444444444"]
If "auto", the Action will use any identities from the current workspace (unless you have provided a list of identity_ids). "managed" will use the Edges pool of identities for an extra credit cost
Available options:
direct, auto, managed Show child attributes
Show child attributes
Callbacks
POST{$request.body#/callback/url}onSave
Body
application/json
Show child attributes
Show child attributes
Represents an error returned by the API. This schema defines the standard structure of error messages to ensure consistent error handling across the application.
Show child attributes
Show child attributes
Number of results in the current callback
Results of the current callback
Show child attributes
Show child attributes
Response
200
Callback successfully processed