> ## Documentation Index
> Fetch the complete documentation index at: https://flows-docs.edges.run/llms.txt
> Use this file to discover all available pages before exploring further.
# LinkedIn Post Likers Enrich
> Extract people who liked a LinkedIn post and enrich them with additional data
The LinkedIn Post Likers Enrich flow extracts all people who liked a LinkedIn post, then optionally enriches them with profile and contact information. This flow is ideal for engagement analysis and lead generation from post interactions.
## Flow Steps
The flow executes steps in the following order:
1. **Extract Post Likers** (required): Extracts all people who liked the specified LinkedIn post
2.
* **`linkedin-extract-people`**: Extracts detailed LinkedIn profile information (sections, experiences, skills, highlights)
* **`linkedin-extract-company`**: Extracts company information for each profile's current company
* **`fullenrich-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.
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:**
```json theme={null}
"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.
**Examples**:
```bash theme={null}
curl --request POST \
--url https://api.edges.run/v1/flows/linkedin-post-likers-enrich/run/async \
--header 'Content-Type: application/json' \
--header 'X-API-Key: ' \
--data '{
"inputs": [
{
"linkedin_post_url": "https://www.linkedin.com/posts/example-post-123"
}
],
"identity_mode": "managed"
}'
```
```bash theme={null}
curl --request POST \
--url https://api.edges.run/v1/flows/linkedin-post-likers-enrich/run/async \
--header 'Content-Type: application/json' \
--header 'X-API-Key: ' \
--data '{
"steps": [
"Extract LinkedIn People Profile",
"Extract LinkedIn Company Profile",
"Full enrich people"
],
"parameters": {
"linkedin-extract-post-likers": {
"max_results": 500,
"skip": 0
},
"linkedin-extract-people": {
"sections": true,
"experiences": true,
"skills": true,
"highlights": true
},
"fullenrich-enrich-people": {
"enrich_level": "emails_and_phones"
}
},
"inputs": [
{
"linkedin_post_url": "https://www.linkedin.com/posts/example-post-123"
}
],
"identity_ids": ["44444444-4444-4444-4444-444444444444"]
}'
```
```bash theme={null}
curl --request POST \
--url https://api.edges.run/v1/flows/linkedin-post-likers-enrich/run/async \
--header 'Content-Type: application/json' \
--header 'X-API-Key: ' \
--data '{
"inputs": [
{
"linkedin_post_url": "https://www.linkedin.com/posts/example-post-123"
}
],
"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](/api/callbacks).
## OpenAPI
````yaml POST /flows/linkedin-post-likers-enrich/run/async
openapi: 3.1.0
info:
title: ED Automation Flows API
description: This is the Flows API documentation for ED Automation
version: dev
servers:
- url: https://api.edges.run/v1
security:
- XApiKeyAuth: []
paths:
/flows/linkedin-post-likers-enrich/run/async:
post:
tags:
- flows
summary: Run linkedin-post-likers-enrich flow asynchronously
description: Used to create and run a given flow preset.
operationId: flowLinkedinPostLikersEnrichAsync
parameters: []
requestBody:
content:
application/json:
schema:
type: object
properties:
steps:
type: array
items:
type: string
enum:
- linkedin-extract-people
- linkedin-extract-company
- fullenrich-enrich-people
description: >-
Optional list of step to run. If not provided, only the
required steps will be run.
parameters:
type: object
properties:
linkedin-extract-post-likers:
type: object
properties:
max_results:
type: integer
title: Maximum number of results
default: 100
maximum: 3000
description: >-
Maximum number of post likers to extract per input.
LinkedIn sometimes limits the number of results you
can get, so it’s possible you won’t reach the
maximum even if you request it.
xAutoPaginate: true
skip:
type: integer
title: Skip
default: 0
maximum: 30000
minimum: 0
description: Number of likers to skip.
xAutoPaginate: true
x-display-widget: numeric
additionalProperties: false
default: {}
linkedin-extract-people:
type: object
properties:
sections:
type: boolean
title: Sections
default: true
description: >-
Extract sections data. When enabled, returns:
`education`, `languages`, `volunteer_experiences`,
`summary`, `company_name`, `job_title`,
`linkedin_company_url`.
x-display-widget: checkbox
experiences:
type: boolean
title: Experiences
default: false
description: >-
Extract a partial list of professional experiences:
includes only the user's most recent or
representative experiences.
x-display-widget: checkbox
skills:
type: boolean
title: Skills
default: false
description: >-
Extract a partial list of skills: includes only a
selection of the user's main competencies, not the
full set - this list can be empty even if the user
has skills listed on their profile.
x-display-widget: checkbox
highlights:
type: boolean
title: Highlights
default: false
description: >-
Extract highlights data. When enabled, returns:
`linkedin_company_url`, `connection_degree`,
`number_followers`, `number_connections`,
`linkedin_thread_id`.
x-display-widget: checkbox
additionalProperties: false
default: {}
linkedin-extract-company:
type: object
properties: {}
additionalProperties: false
default: {}
fullenrich-enrich-people:
type: object
properties:
enrich_level:
type: string
title: Enrich Level
default: emails
description: The level you want to enrich.
enum:
- emails
- phones
- emails_and_phones
x-display-widget: select
additionalProperties: false
default: {}
additionalProperties: false
inputs:
type: array
items:
$ref: '#/components/schemas/FlowLinkedinPostLikersEnrichInput'
minItems: 1
maxItems: 1000
identity_ids:
type: array
description: >-
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.
items:
type: string
format: uuid
nullable: true
example:
- 44444444-4444-4444-4444-444444444444
identity_mode:
type: string
enum:
- direct
- auto
- managed
default: direct
nullable: true
description: >-
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
callback:
type: object
properties:
url:
type: string
description: >-
URL to send the results to. The Action will send a POST
request with the results to this URL. The request will
include a JSON body with the results of the Action.
nullable: true
pattern: ^(https?:\/\/[^\s]+)$
example: https://example.com/callback
headers:
type: object
description: Headers to include in the callback request.
additionalProperties:
type: string
'on':
type: string
description: >-
Define when you want to receive callbacks. "all" will
send callbacks to stream outputs, "final" will send a
single callback when all inputs are processed or an
error occured on the run.
enum:
- all
- final
default: all
required:
- url
additionalProperties: false
required:
- inputs
responses:
'200':
$ref: '#/components/responses/FlowAsyncResponse'
'400':
$ref: '#/components/responses/BadRequest'
'424':
$ref: '#/components/responses/FailedDependency'
'500':
$ref: '#/components/responses/InternalServerError'
callbacks:
onSave:
'{$request.body#/callback/url}':
post:
responses:
'200':
description: Callback successfully processed
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
flow_run:
type: object
properties:
flow_run_uid:
type: string
format: uuid
description: Run UUID
step_uid:
type: string
format: uuid
description: Output Step UUID
nullable: true
status:
type: string
enum:
- CREATED
- INVALID
- QUEUED
- SCHEDULED
- BLOCKED
- STOPPED
- RUNNING
- FAILED
- PARTIAL_SUCCEEDED
- SUCCEEDED
description: Flow status
scheduled_flow_run_uid:
type: string
format: uuid
description: >-
If the flow run is scheduled, this field
indicates the scheduled flow run UUID.
nullable: true
required:
- flow_run_uid
- status
error:
$ref: '#/components/schemas/APIError'
results_count:
type: integer
description: Number of results in the current callback
results:
type: array
items:
$ref: >-
#/components/schemas/FlowLinkedinPostLikersEnrichOutput
description: Results of the current callback
required:
- run
method: post
type: path
path: '{$request.body#/callback/url}'
components:
schemas:
FlowLinkedinPostLikersEnrichInput:
type: object
properties:
linkedin_post_url:
pattern: >-
/^https:\/\/(?:(www|[a-z]{2})\.)?linkedin\.com\/(posts|feed)\/[\w%-]+/
type: string
format: uri
description: >-
A LinkedIn Post URL should start with
"https://www.linkedin.com/posts/".
x-primary: true
x-help: >-
A LinkedIn Post URL should start with
"https://www.linkedin.com/posts/".
custom_data:
type: object
additionalProperties: true
description: Custom data (ex-metadata)
properties:
meta: {}
additionalProperties: false
required:
- linkedin_post_url
APIError:
title: APIError
description: >-
Represents an error returned by the API. This schema defines the
standard structure of error messages to ensure consistent error handling
across the application.
type: object
properties:
error_label:
type: string
nullable: true
error_scope:
type: string
enum:
- input
- integ
- param
- config
nullable: true
error_ref:
type: string
examples:
- ERR-12345
nullable: true
message:
type: string
status_code:
type: integer
nullable: true
params:
type: object
patternProperties:
^[^_].*:
anyOf:
- type: string
- type: number
- type: boolean
- type: 'null'
- type: array
items:
type: string
additionalProperties: false
nullable: true
data:
type: object
nullable: true
additionalProperties: true
description: Additional data about the error
additionalProperties: false
FlowLinkedinPostLikersEnrichOutput:
type: object
properties:
custom_data:
type: object
additionalProperties: true
description: Custom data (ex-metadata)
properties:
meta: {}
company_name: {}
company_specialties: {}
company_tagline: {}
linkedin_company_id: {}
company_description: {}
company_type: {}
company_founded_on: {}
linkedin_company_url: {}
company_website: {}
linkedin_company_phone: {}
sales_navigator_company_url: {}
company_industries: {}
company_industries_v1: {}
company_industry: {}
company_linkedin_job_search_url: {}
company_followers_count: {}
company_number_employees: {}
company_employees_range: {}
company_linkedin_employees_url: {}
company_sales_navigator_employees_url: {}
company_country: {}
company_geographic_area: {}
company_city: {}
company_postal_code: {}
company_headquarters: {}
company_locations: {}
company_number_of_locations: {}
company_last_funding_investors: {}
crunchbase_company_url: {}
company_last_funding_date: {}
company_last_funding_type: {}
company_last_funding_raised: {}
company_last_funding_currency: {}
company_logo_url: {}
company_domain: {}
company_location: {}
company_linkedin_school_id: {}
company_linkedin_page_claimed: {}
company_updated_at: {}
company_affiliates: {}
linkedin_profile_handle: {}
first_name: {}
last_name: {}
full_name: {}
birth_date: {}
headline: {}
summary: {}
languages: {}
skills: {}
sales_navigator_profile_id: {}
linkedin_profile_id: {}
linkedin_profile_url: {}
profile_country: {}
profile_language: {}
location: {}
profile_image_url: {}
job_title: {}
education: {}
school_name: {}
linkedin_school_url: {}
volunteer_experiences: {}
number_connections: {}
experiences: {}
number_followers: {}
linkedin_people_post_search_url: {}
connection_degree: {}
open_to_work: {}
linkedin_thread_id: {}
past_company_name: {}
past_job_title: {}
past_sales_navigator_company_id: {}
past_linkedin_company_id: {}
past_linkedin_company_url: {}
connected_at: {}
reaction_type: {}
reaction_urn: {}
liker_connection_degree: {}
sales_navigator_profile_url: {}
linkedin_post_url: {}
linkedin_post_id: {}
domain: {}
emails: {}
email: {}
phones: {}
email_status: {}
email_status_normalized: {}
BadRequest:
title: APIError
description: >-
Represents an error returned by the API. This schema defines the
standard structure of error messages to ensure consistent error handling
across the application.
type: object
properties:
error_label:
type: string
nullable: true
error_scope:
type: string
enum:
- input
- integ
- param
- config
nullable: true
error_ref:
type: string
nullable: true
example: ERR-12345
message:
type: string
status_code:
type: integer
nullable: true
params:
type: object
additionalProperties:
anyOf:
- type: string
- type: number
- type: boolean
- type: 'null'
- type: array
items:
type: string
nullable: true
data:
type: object
nullable: true
additionalProperties: true
description: Additional data about the error
additionalProperties: false
FailedDependency:
title: APIError
description: >-
Represents an error returned by the API. This schema defines the
standard structure of error messages to ensure consistent error handling
across the application.
type: object
properties:
error_label:
type: string
nullable: true
error_scope:
type: string
enum:
- input
- integ
- param
- config
nullable: true
error_ref:
type: string
nullable: true
example: ERR-12345
message:
type: string
status_code:
type: integer
nullable: true
params:
type: object
additionalProperties:
anyOf:
- type: string
- type: number
- type: boolean
- type: 'null'
- type: array
items:
type: string
nullable: true
data:
type: object
nullable: true
additionalProperties: true
description: Additional data about the error
additionalProperties: false
InternalServerError:
title: APIError
description: >-
Represents an error returned by the API. This schema defines the
standard structure of error messages to ensure consistent error handling
across the application.
type: object
properties:
error_label:
type: string
nullable: true
error_scope:
type: string
enum:
- input
- integ
- param
- config
nullable: true
error_ref:
type: string
nullable: true
example: ERR-12345
message:
type: string
status_code:
type: integer
nullable: true
params:
type: object
additionalProperties:
anyOf:
- type: string
- type: number
- type: boolean
- type: 'null'
- type: array
items:
type: string
nullable: true
data:
type: object
nullable: true
additionalProperties: true
description: Additional data about the error
additionalProperties: false
responses:
FlowAsyncResponse:
description: Successful response
content:
application/json:
schema:
description: Successful response
type: object
properties:
uid:
type: string
format: uuid
workflow:
type: object
properties:
uid:
type: string
metadata:
type: object
properties:
account_rotation:
type: boolean
default: true
nullable: true
additionalProperties: false
additionalProperties: false
additionalProperties: false
BadRequest:
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequest'
FailedDependency:
description: Failed Dependency
content:
application/json:
schema:
$ref: '#/components/schemas/FailedDependency'
InternalServerError:
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerError'
securitySchemes:
XApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
````