--- title: research linkedin description: Research public LinkedIn profiles and posts. canonical_url: https://orchestor.io/docs/en/cli/research/linkedin markdown_url: https://orchestor.io/docs/en/cli/research/linkedin.md contentType: reference --- # research linkedin `orc research linkedin` retrieves public LinkedIn profiles, companies and posts and searches people or posts. Use company IDs or member URNs to find public posts, then inspect content or comments from activity URLs. Authenticate the CLI and select an accessible Workspace. Use `--workspace` to set the scope for this call. ## Usage ```bash title="terminal" orc research linkedin profiles get --url https://www.linkedin.com/in/example/ --workspace --json ``` *Retrieve a public profile.* ## Subcommands ### `companies get` Retrieve a company from its public URL. Use the returned `data.author.id` for company people and post lists. ```bash title="terminal" orc research linkedin companies get [options] ``` #### Unique options ##### `--url` Public LinkedIn company URL.; max 2048 chars Type: `string`. Required. ```bash title="terminal" orc research linkedin companies get --url ``` ### `companies people list` List people for a numeric company ID. `--include profile` retrieves fresh profiles at up to four additional provider credits per returned row. ```bash title="terminal" orc research linkedin companies people list [options] ``` #### Unique options ##### `--company-id` Numeric company ID from company data.author.id, not a slug or URL. Type: `string`. Required. ```bash title="terminal" orc research linkedin companies people list --company-id ``` ##### `--include` Join fresh profile details. Adds up to 4 provider credits per returned row.; enum: profile Type: `string`. Optional. ```bash title="terminal" orc research linkedin companies people list --include ``` ##### `--page` One-based provider page. Do not combine with cursor. Type: `number`. Optional. ```bash title="terminal" orc research linkedin companies people list --page ``` ### `companies posts list` Retrieve public posts for a numeric company ID. `--sort-by` accepts `top` or `recent`. ```bash title="terminal" orc research linkedin companies posts list [options] ``` #### Unique options ##### `--company-id` Numeric company ID from company data.author.id, not a slug or URL. Type: `string`. Required. ```bash title="terminal" orc research linkedin companies posts list --company-id ``` ##### `--sort-by` Provider ordering for company posts: top or recent. Omission sends no ordering override.; enum: top|recent Type: `string`. Optional. ```bash title="terminal" orc research linkedin companies posts list --sort-by ``` ##### `--page` One-based provider page. Do not combine with cursor. Type: `number`. Optional. ```bash title="terminal" orc research linkedin companies posts list --page ``` ### `posts get` Retrieve a public post using an activity URL. URLs identifying share or ugcPost IDs are not accepted. ```bash title="terminal" orc research linkedin posts get [options] ``` #### Unique options ##### `--url` Public LinkedIn post URL. Post URLs must identify an activity, not share/ugcPost IDs.; max 2048 chars Type: `string`. Required. ```bash title="terminal" orc research linkedin posts get --url ``` ### `posts comments list` Retrieve comments using a public activity URL. `--post-type` supplies a provider hint without changing the URL requirement. ```bash title="terminal" orc research linkedin posts comments list [options] ``` #### Unique options ##### `--url` Public LinkedIn post URL. Post URLs must identify an activity, not share/ugcPost IDs.; max 2048 chars Type: `string`. Required. ```bash title="terminal" orc research linkedin posts comments list --url ``` ##### `--post-type` Provider post-type hint for comment retrieval. The url must still be an accepted activity URL. Omission sends no type override.; enum: activity|ugc Type: `string`. Optional. ```bash title="terminal" orc research linkedin posts comments list --post-type ``` ##### `--sort-order` Provider comment ordering: recency or relevance. Omission sends no ordering override.; enum: recent|relevance Type: `string`. Optional. ```bash title="terminal" orc research linkedin posts comments list --sort-order ``` ##### `--page` One-based provider page. Do not combine with cursor. Type: `number`. Optional. ```bash title="terminal" orc research linkedin posts comments list --page ``` ### `profiles get` Retrieve a profile from its public URL. ```bash title="terminal" orc research linkedin profiles get [options] ``` #### Unique options ##### `--url` Public LinkedIn profile URL.; max 2048 chars Type: `string`. Required. ```bash title="terminal" orc research linkedin profiles get --url ``` ### `profiles posts list` Retrieve recent posts for a public profile URL. The maximum is 100 and the provider default is 20; this endpoint does not paginate beyond the returned set. ```bash title="terminal" orc research linkedin profiles posts list [options] ``` #### Unique options ##### `--url` Public LinkedIn profile URL.; max 2048 chars Type: `string`. Required. ```bash title="terminal" orc research linkedin profiles posts list --url ``` ##### `--urn` Bare member URN from profile data.author.ext.urn; not a profile URL or prefixed URN. Type: `string`. Optional. ```bash title="terminal" orc research linkedin profiles posts list --urn ``` ### `people search` Search people with `--query`, then filter by name, title, employer or profile language. Employer filters use numeric company IDs rather than names. ```bash title="terminal" orc research linkedin people search [options] ``` #### Unique options ##### `--query` Search text.; max 500 chars Type: `string`. Required. ```bash title="terminal" orc research linkedin people search --query ``` ##### `--first-name` Additional first-name search filter. Omit to leave unspecified; query remains required.; max 500 chars Type: `string`. Optional. ```bash title="terminal" orc research linkedin people search --first-name ``` ##### `--last-name` Additional last-name search filter. Omit to leave unspecified; query remains required.; max 500 chars Type: `string`. Optional. ```bash title="terminal" orc research linkedin people search --last-name ``` ##### `--title` Job-title search filter forwarded to the provider. Omit to leave unspecified.; max 500 chars Type: `string`. Optional. ```bash title="terminal" orc research linkedin people search --title ``` ##### `--current-company` Comma-separated numeric company IDs, for example 1001,1002. Names and URLs are not accepted. Omit to leave current company unrestricted.; max 500 chars Type: `string`. Optional. ```bash title="terminal" orc research linkedin people search --current-company ``` ##### `--past-company` Numeric previous-employer company ID. Omit to leave past company unrestricted. Type: `string`. Optional. ```bash title="terminal" orc research linkedin people search --past-company ``` ##### `--profile-language` Two-lowercase-letter profile-language filter, for example en or ja. Omission sends no language filter. Type: `string`. Optional. ```bash title="terminal" orc research linkedin people search --profile-language ``` ##### `--include` Join fresh profile details. Adds up to 4 provider credits per returned row.; enum: profile Type: `string`. Optional. ```bash title="terminal" orc research linkedin people search --include ``` ##### `--page` One-based provider page. Do not combine with cursor. Type: `number`. Optional. ```bash title="terminal" orc research linkedin people search --page ``` ### `posts search` Find public posts using search text, a company ID or member URN. Relevance ordering requires search text and cannot be used with company/member-only searches. ```bash title="terminal" orc research linkedin posts search [options] ``` #### Unique options ##### `--query` Search text.; max 500 chars Type: `string`. Optional. ```bash title="terminal" orc research linkedin posts search --query ``` ##### `--from-company` Numeric company ID from company data.author.id, not a slug or URL. Type: `string`. Optional. ```bash title="terminal" orc research linkedin posts search --from-company ``` ##### `--from-member` Bare member URN from profile data.author.ext.urn; not a profile URL or prefixed URN. Type: `string`. Optional. ```bash title="terminal" orc research linkedin posts search --from-member ``` ##### `--sort-by` Provider ordering. relevance requires query; member/company-only searches cannot request relevance. Omission sends no sort override.; enum: date_posted|relevance Type: `string`. Optional. ```bash title="terminal" orc research linkedin posts search --sort-by ``` ##### `--date-posted` Provider publication recency window. Omission sends no recency filter.; enum: past_24h|past_week|past_month Type: `string`. Optional. ```bash title="terminal" orc research linkedin posts search --date-posted ``` ##### `--content-type` Restrict search to a provider content category. Omission sends no content-type filter.; enum: videos|photos|jobs|live_videos|documents|collaborative_articles Type: `string`. Optional. ```bash title="terminal" orc research linkedin posts search --content-type ``` ##### `--page` One-based provider page. Do not combine with cursor. Type: `number`. Optional. ```bash title="terminal" orc research linkedin posts search --page ``` ## Examples ### Filter a people search by job title. ```bash title="terminal" orc research linkedin people search --query "engineer" --title "software engineer" --workspace --json ``` *Filter a people search by job title.* ## Output and continuation For lists with continuation, pass the API’s top-level `pagination.next_cursor` as `--cursor` with unchanged filters. In CLI JSON, extract `data.pagination.next_cursor`; do not replay a cursor nested inside source records. `has_more: null` means unknown rather than complete. `--page-all` is unavailable. With `--json`, the full API response is retained inside the CLI `data` envelope. Records are in `data.data`, continuation in `data.pagination`, and provenance in `data.source`. `--raw` removes the CLI envelope; `--field data` selects API data. Missing and null values do not mean zero. `data.usage.provider_credits` uses provider units, not Orchestor billing units. Do not combine `--page` and `--cursor`. For people lists and searches, `--limit` returns the first one to ten rows of the source page; skipped rows are not carried forward. ## Permissions API keys require read scope. Provider credentials are managed by the server. ## Global Options The following [global options](https://orchestor.io/docs/cli/global-flags.md) can be used with `orc research linkedin`: - [`--help`](https://orchestor.io/docs/cli/global-flags.md#help) - [`--workspace`](https://orchestor.io/docs/cli/global-flags.md#workspace) - [`--json`](https://orchestor.io/docs/cli/global-flags.md#json-output) - [`--pretty`](https://orchestor.io/docs/cli/global-flags.md#json-output) - [`--format`](https://orchestor.io/docs/cli/global-flags.md#output-format) - [`--field`](https://orchestor.io/docs/cli/global-flags.md#field-selection) - [`--fields`](https://orchestor.io/docs/cli/global-flags.md#field-selection) - [`--raw`](https://orchestor.io/docs/cli/global-flags.md#raw-output) - [`--output`](https://orchestor.io/docs/cli/global-flags.md#file-output) - [`--no-pager`](https://orchestor.io/docs/cli/global-flags.md#pager) - [`--dry-run`](https://orchestor.io/docs/cli/global-flags.md#dry-run) - [`--yes`](https://orchestor.io/docs/cli/global-flags.md#confirmation) - [`--limit`](https://orchestor.io/docs/cli/global-flags.md) - [`--cursor`](https://orchestor.io/docs/cli/global-flags.md) - [`--stdin`](https://orchestor.io/docs/cli/global-flags.md#standard-input) - [`--from-stdin`](https://orchestor.io/docs/cli/global-flags.md#standard-input) - [`--timing`](https://orchestor.io/docs/cli/global-flags.md#request-timing) For details and examples, see [global options](https://orchestor.io/docs/cli/global-flags.md). ## Related commands - Research overview - [Global options](https://orchestor.io/docs/en/cli/global-flags.md) --- [Documentation index](https://orchestor.io/docs/llms.txt)