LinkedIn Skill

You have access to linkedin – a CLI tool for LinkedIn automation. Use it to fetch profiles, search people and companies, send messages, manage connections, create posts, react, comment, and more.

Each command sends a request to Linked API, which runs a real cloud browser to perform the action on LinkedIn. Operations are not instant – expect 30 seconds to several minutes depending on complexity.

If linkedin is not available, install it:

CODEBLOCK0

Authentication

If a command fails with exit code 2 (authentication error), ask the user to set up their account:

1. 1. Go to app.linkedapi.io and sign up or log in
2. Connect their LinkedIn account
3. Copy the Linked API Token and Identification Token from the dashboard

Once the user provides the tokens, run:

CODEBLOCK1

Global Flags

Always use --json and -q for machine-readable output:

CODEBLOCK2

Flag	Description
INLINECODE4	Structured JSON output
INLINECODE5 / INLINECODE6

Suppress stderr progress messages |
| --fields name,url,... | Select specific fields in output |
| --no-color | Disable colors |
| --account "Name" | Use a specific account for this command |

Output Format

Success:
CODEBLOCK3

Error:
CODEBLOCK4

Exit code 0 means the API call succeeded – always check the success field for the action outcome. Non-zero exit codes indicate infrastructure errors:

Exit Code	Meaning
0	Success (check success field – action may have returned an error like "person not found")
1

General/unexpected error |
| 2 | Missing or invalid tokens |
| 3 | Subscription/plan required |
| 4 | LinkedIn account issue |
| 5 | Invalid arguments |
| 6 | Rate limited |
| 7 | Network error |
| 8 | Workflow timeout (workflowId returned for recovery) |

Commands

Fetch a Person Profile

CODEBLOCK5

Optional flags to include additional data:

• - --experience – work history
• INLINECODE13 – education history
• INLINECODE14 – skills list
• INLINECODE15 – languages
• INLINECODE16 – recent posts (with --posts-limit N, --posts-since TIMESTAMP)
• INLINECODE19 – recent comments (with --comments-limit N, --comments-since TIMESTAMP)
• INLINECODE22 – recent reactions (with --reactions-limit N, --reactions-since TIMESTAMP)

Only request additional data when needed – each flag increases execution time.

CODEBLOCK6

Search People

CODEBLOCK7

Flag	Description
INLINECODE25	Search keyword or phrase
INLINECODE26

Max results |
| --first-name | Filter by first name |
| --last-name | Filter by last name |
| --position | Filter by job position |
| --locations | Comma-separated locations |
| --industries | Comma-separated industries |
| --current-companies | Comma-separated current company names |
| --previous-companies | Comma-separated previous company names |
| --schools | Comma-separated school names |

CODEBLOCK8

Fetch a Company

CODEBLOCK9

Optional flags:

• - --employees – include employees
• INLINECODE36 – include decision makers
• INLINECODE37 – include company posts

Employee filters (require --employees):

Flag	Description
INLINECODE39	Max employees to retrieve
INLINECODE40

Filter by first name |
| --employees-last-name | Filter by last name |
| --employees-position | Filter by position |
| --employees-locations | Comma-separated locations |
| --employees-industries | Comma-separated industries |
| --employees-schools | Comma-separated school names |

Flag	Description
INLINECODE46	Max decision makers to retrieve (requires --dms)
INLINECODE48

Max posts to retrieve (requires --posts) |
| --posts-since | Posts since ISO timestamp (requires --posts) |

CODEBLOCK10

Search Companies

CODEBLOCK11

Flag	Description
INLINECODE52	Search keyword
INLINECODE53

Max results |
| --sizes | Comma-separated sizes: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+ |
| --locations | Comma-separated locations |
| --industries | Comma-separated industries |

CODEBLOCK12

Send a Message

CODEBLOCK13

Text up to 1900 characters. Wrap the message in single quotes to avoid shell interpretation issues.

CODEBLOCK14

Get Conversation

CODEBLOCK15

The first call for a conversation triggers a background sync and may take longer. Subsequent calls are faster.

CODEBLOCK16

Connection Management

Check connection status

CODEBLOCK17

Send connection request

CODEBLOCK18

List connections

CODEBLOCK19

Flag	Description
INLINECODE65	Max connections to return
INLINECODE66

Only connections made since ISO timestamp (only works when no filter flags are used) |
| --first-name | Filter by first name |
| --last-name | Filter by last name |
| --position | Filter by job position |
| --locations | Comma-separated locations |
| --industries | Comma-separated industries |
| --current-companies | Comma-separated current company names |
| --previous-companies | Comma-separated previous company names |
| --schools | Comma-separated school names |

CODEBLOCK20

List pending outgoing requests

CODEBLOCK21

Withdraw a pending request

CODEBLOCK22

By default, withdrawing also unfollows the person. Use --no-unfollow to keep following.

Remove a connection

CODEBLOCK23

Posts

Fetch a post

CODEBLOCK24

Flag	Description
INLINECODE76	Include comments
INLINECODE77

Include reactions |
| --comments-limit | Max comments to retrieve (requires --comments) |
| --comments-sort | Sort order: mostRelevant or mostRecent (requires --comments) |
| --comments-replies | Include replies to comments (requires --comments) |
| --reactions-limit | Max reactions to retrieve (requires --reactions) |

CODEBLOCK25

Create a post

CODEBLOCK26

Flag	Description
INLINECODE88	Post on behalf of a company page (requires admin access)
INLINECODE89

Attachment as url:type or url:type:name. Types: image, video, document. Can be specified multiple times. |

Attachment limits: up to 9 images, or 1 video, or 1 document. Cannot mix types.

CODEBLOCK27

React to a post

CODEBLOCK28

Reaction types: like, love, support, celebrate, insightful, funny.

CODEBLOCK29

Comment on a post

CODEBLOCK30

Text up to 1000 characters.

CODEBLOCK31

Statistics

CODEBLOCK32

Sales Navigator

Requires a LinkedIn Sales Navigator subscription. Uses hashed URLs for person/company lookups.

Fetch person

CODEBLOCK33

Search people

CODEBLOCK34

Flag	Description
INLINECODE101	Search keyword or phrase
INLINECODE102

Max results |
| --first-name | Filter by first name |
| --last-name | Filter by last name |
| --position | Filter by job position |
| --locations | Comma-separated locations |
| --industries | Comma-separated industries |
| --current-companies | Comma-separated current company names |
| --previous-companies | Comma-separated previous company names |
| --schools | Comma-separated school names |
| --years-of-experience | Comma-separated ranges: lessThanOne, oneToTwo, threeToFive, sixToTen, moreThanTen |

CODEBLOCK35

Fetch company

CODEBLOCK36

Optional flags:

• - --employees – include employees
• INLINECODE118 – include decision makers

Employee filters (require --employees):

Flag	Description
INLINECODE120	Max employees to retrieve
INLINECODE121

Filter by first name |
| --employees-last-name | Filter by last name |
| --employees-positions | Comma-separated positions |
| --employees-locations | Comma-separated locations |
| --employees-industries | Comma-separated industries |
| --employees-schools | Comma-separated school names |
| --employees-years-of-experience | Comma-separated experience ranges |
| --dms-limit | Max decision makers to retrieve (requires --dms) |

CODEBLOCK37

Search companies

CODEBLOCK38

Flag	Description
INLINECODE130	Search keyword
INLINECODE131

Max results |
| --sizes | Comma-separated sizes: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+ |
| --locations | Comma-separated locations |
| --industries | Comma-separated industries |
| --revenue-min | Min annual revenue in M USD: 0, 0.5, 1, 2.5, 5, 10, 20, 50, 100, 500, 1000 |
| --revenue-max | Max annual revenue in M USD: 0.5, 1, 2.5, 5, 10, 20, 50, 100, 500, 1000, 1000+ |

CODEBLOCK39

Send InMail

CODEBLOCK40

Text up to 1900 characters. Subject up to 80 characters.

CODEBLOCK41

Get Sales Navigator conversation

CODEBLOCK42

Custom Workflows

Execute a custom workflow definition from a file, stdin, or inline:

CODEBLOCK43

Check workflow status or wait for completion:

CODEBLOCK44

See Building Workflows for the workflow JSON schema.

Account Management

CODEBLOCK45

Important Behavior

• - Sequential execution. All operations for an account run one at a time. Multiple requests queue up.
• Not instant. A real browser navigates LinkedIn – expect 30 seconds to several minutes per operation.
• Timestamps in UTC. All dates and times are in UTC.
• Single quotes for text arguments. Use single quotes around message text, post text, and comments to avoid shell interpretation issues with special characters.
• Action limits. Per-account limits are configurable on the platform. A limitExceeded error means the limit was reached.
• URL normalization. All LinkedIn URLs in responses are normalized to https://www.linkedin.com/... format without trailing slashes.
• Null fields. Fields that are unavailable are returned as null or [], not omitted.