​

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.

Retrieve a public profile.

Retrieve a company from its public URL. Use the returned data.author.id for company people and post lists.

Public LinkedIn company URL.; max 2048 chars

Type: string. Required.

List people for a numeric company ID. --include profile retrieves fresh profiles at up to four additional provider credits per returned row.

Numeric company ID from company data.author.id, not a slug or URL.

Type: string. Required.

Join fresh profile details. Adds up to 4 provider credits per returned row.; enum: profile

Type: string. Optional.

One-based provider page. Do not combine with cursor.

Type: number. Optional.

Retrieve public posts for a numeric company ID. --sort-by accepts top or recent.

Numeric company ID from company data.author.id, not a slug or URL.

Type: string. Required.

Provider ordering for company posts: top or recent. Omission sends no ordering override.; enum: top|recent

Type: string. Optional.

One-based provider page. Do not combine with cursor.

Type: number. Optional.

Retrieve a public post using an activity URL. URLs identifying share or ugcPost IDs are not accepted.

Public LinkedIn post URL. Post URLs must identify an activity, not share/ugcPost IDs.; max 2048 chars

Type: string. Required.

Retrieve comments using a public activity URL. --post-type supplies a provider hint without changing the URL requirement.

Public LinkedIn post URL. Post URLs must identify an activity, not share/ugcPost IDs.; max 2048 chars

Type: string. Required.

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.

Provider comment ordering: recency or relevance. Omission sends no ordering override.; enum: recent|relevance

Type: string. Optional.

One-based provider page. Do not combine with cursor.

Type: number. Optional.

Retrieve a profile from its public URL.

Public LinkedIn profile URL.; max 2048 chars

Type: string. Required.

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.

Public LinkedIn profile URL.; max 2048 chars

Type: string. Required.

Bare member URN from profile data.author.ext.urn; not a profile URL or prefixed URN.

Type: string. Optional.

Search people with --query, then filter by name, title, employer or profile language. Employer filters use numeric company IDs rather than names.

Search text.; max 500 chars

Type: string. Required.

Additional first-name search filter. Omit to leave unspecified; query remains required.; max 500 chars

Type: string. Optional.

Additional last-name search filter. Omit to leave unspecified; query remains required.; max 500 chars

Type: string. Optional.

Job-title search filter forwarded to the provider. Omit to leave unspecified.; max 500 chars

Type: string. Optional.

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.

Numeric previous-employer company ID. Omit to leave past company unrestricted.

Type: string. Optional.

Two-lowercase-letter profile-language filter, for example en or ja. Omission sends no language filter.

Type: string. Optional.

Join fresh profile details. Adds up to 4 provider credits per returned row.; enum: profile

Type: string. Optional.

One-based provider page. Do not combine with cursor.

Type: number. Optional.

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.

Search text.; max 500 chars

Type: string. Optional.

Numeric company ID from company data.author.id, not a slug or URL.

Type: string. Optional.

Bare member URN from profile data.author.ext.urn; not a profile URL or prefixed URN.

Type: string. Optional.

Provider ordering. relevance requires query; member/company-only searches cannot request relevance. Omission sends no sort override.; enum: date_posted|relevance

Type: string. Optional.

Provider publication recency window. Omission sends no recency filter.; enum: past_24h|past_week|past_month

Type: string. Optional.

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.

One-based provider page. Do not combine with cursor.

Type: number. Optional.

Filter a people search by job title.

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.

API keys require read scope. Provider credentials are managed by the server.

The following global options can be used with orc research linkedin:

For details and examples, see global options.