> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adside.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# LinkedIn

> The 28 adside commands for LinkedIn.

See [Using commands](https://docs.adside.ai/cli/commands.md) for how flags, JSON input, paging and confirmations work. Run `adside linkedin --help` to see what your installed version has.

## linkedin ad-accounts

### linkedin ad-accounts get

Get details of a LinkedIn Ad Account (name, status, currency, type, serving statuses).

Beta: this command may still change.

```bash theme={null}
adside linkedin ad-accounts get [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--account-id` | `<id>` | LinkedIn Ad Account ID (numeric). Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |

### linkedin ad-accounts list

Get the one LinkedIn Ad Account this workspace is connected to.

Beta: this command may still change.

```bash theme={null}
adside linkedin ad-accounts list
```

## linkedin ad-segment

### linkedin ad-segment get

Look up one audience segment by its urn:li:adSegment: URN or id.

Beta: this command may still change.

```bash theme={null}
adside linkedin ad-segment get --segment-id <id>
```

| Flag | Value | What it does |
| - | - | - |
| `--segment-id` (required) | `<id>` | The segment's numeric id, or the full urn:li:adSegment:… as it appears inside a targeting\_criteria. |

## linkedin ad-segments

### linkedin ad-segments list

List the audience segments an ad account owns: uploaded contact/company lists (type BULK) and website or engagement retargeting audiences (type RETARGETING).

Beta: this command may still change.

```bash theme={null}
adside linkedin ad-segments list [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--account-id` | `<id>` | LinkedIn Ad Account ID (numeric). Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |
| `--start` | `<min 0>=0` | Index of the first segment to return (offset paging). |
| `--count` | `<1-1000>=100` | How many segments to return. LinkedIn defaults to 10 if unset, so this tool asks for 100; check `next_start` in the response for more. |

## linkedin analytics

### linkedin analytics get

Get performance analytics (impressions, clicks, cost, conversions, etc.) for LinkedIn ad entities.

Beta: this command may still change.

```bash theme={null}
adside linkedin analytics get --pivot ACCOUNT|CAMPAIGN_GROUP|CAMPAIGN|CREATIVE --date-range-start '<json>' [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--pivot` (required) | `ACCOUNT\|CAMPAIGN_GROUP\|CAMPAIGN\|CREATIVE` | Dimension to group results by |
| `--date-range-start` (required) | `'<json>'` | Start date (inclusive) |
| `--account-id` | `<id>` | LinkedIn Ad Account ID. Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |
| `--time-granularity` | `DAILY\|MONTHLY\|ALL=ALL` | Time granularity for results |
| `--date-range-end` | `'<json>'` | End date (inclusive). If omitted, returns data up to now. |
| `--campaign-ids` | `'<json>'` | Filter by campaign IDs |
| `--campaign-group-ids` | `'<json>'` | Filter by campaign group IDs |
| `--creative-ids` | `'<json>'` | Filter by creative URNs |
| `--fields` | `'<json>'` | Specific metrics to return (max 20). Default: impressions, clicks. Examples: costInLocalCurrency, landingPageClicks, likes, shares, externalWebsiteConversions |

## linkedin audience-size-estimate

### linkedin audience-size-estimate get

Estimate how many LinkedIn members match a targeting criteria.

Beta: this command may still change.

```bash theme={null}
adside linkedin audience-size-estimate get --targeting-criteria '<json>'
```

| Flag | Value | What it does |
| - | - | - |
| `--targeting-criteria` (required) | `'<json>'` | Targeting criteria with AND/OR structure. Keys are FACET URNs, not bare names: \{"include":\{"and":\[\{"or":\{"urn:li:adTargetingFacet:locations":\["urn:li:geo:105015875"]}}]}}. A bare "locations" key is refused. Same format as campaign targeting; get the URNs from `adside linkedin targeting-facets search`. |

## linkedin campaign-conversion-rules

### linkedin campaign-conversion-rules list

List which conversion rules are attached to the given campaigns.

Beta: this command may still change.

```bash theme={null}
adside linkedin campaign-conversion-rules list --campaign-ids '<json>'
```

| Flag | Value | What it does |
| - | - | - |
| `--campaign-ids` (required) | `'<json>'` | Campaign ids (numeric) or urn:li:sponsoredCampaign: URNs to look up. |

## linkedin campaign-groups

### linkedin campaign-groups get

Get the complete configuration for one LinkedIn campaign group, including schedule, budget, audit/version, objective, and delivery settings.

Beta: this command may still change.

```bash theme={null}
adside linkedin campaign-groups get --campaign-group-id <id> [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--campaign-group-id` (required) | `<id>` | Campaign group ID or urn:li:sponsoredCampaignGroup URN |
| `--account-id` | `<id>` | |

### linkedin campaign-groups list

Search and list campaign groups for a LinkedIn Ad Account.

Beta: this command may still change.

```bash theme={null}
adside linkedin campaign-groups list [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--account-id` | `<id>` | LinkedIn Ad Account ID. Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |
| `--status` | `ACTIVE\|ARCHIVED\|CANCELED\|DRAFT\|PAUSED\|PENDING_DELETION\|REMOVED` | Filter by campaign group status |
| `--name` | `<name>` | Filter by campaign group name |
| `--test` | `true\|false` | Filter by test (true) or non-test (false) campaign groups |
| `--sort-order` | `ASCENDING\|DESCENDING` | Sort order by campaign group ID (default: ASCENDING) |
| `--page-size` | `<1-1000>=100` | Number of results per page (max 1000) |
| `--page-token` | `<next>` | Cursor token for next page of results |

## linkedin campaign-readiness

### linkedin campaign-readiness verify

Verify campaign readiness by checking serving statuses, budget, targeting, and LinkedIn's cross-field campaign rules (objective/format, optimization target/cost type, Connected TV).

Beta: this command may still change.

```bash theme={null}
adside linkedin campaign-readiness verify [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--account-id` | `<id>` | LinkedIn Ad Account ID. Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |
| `--campaign-id` | `<id>` | Specific campaign ID to verify. If omitted, checks all ACTIVE campaigns. |

## linkedin campaigns

### linkedin campaigns get

Get the complete configuration for one LinkedIn campaign, including targetingCriteria, version, schedule, optimization, budget, audit stamps, and delivery settings.

Beta: this command may still change.

```bash theme={null}
adside linkedin campaigns get --campaign-id <id> [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--campaign-id` (required) | `<id>` | Campaign ID or urn:li:sponsoredCampaign URN |
| `--account-id` | `<id>` | LinkedIn Ad Account ID. Omit it: it defaults to the connected account. |

### linkedin campaigns list

List campaigns for a LinkedIn Ad Account.

Beta: this command may still change.

```bash theme={null}
adside linkedin campaigns list [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--account-id` | `<id>` | LinkedIn Ad Account ID. Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |
| `--status` | `ACTIVE\|PAUSED\|ARCHIVED\|COMPLETED\|CANCELED\|DRAFT\|PENDING_DELETION\|REMOVED` | Filter by campaign status |
| `--campaign-group-id` | `<id>` | Filter by campaign group ID |
| `--type` | `TEXT_AD\|SPONSORED_UPDATES\|SPONSORED_INMAILS\|DYNAMIC` | Filter by campaign type |
| `--name` | `<name>` | Filter by campaign name |
| `--test` | `true\|false` | Filter by test (true) or non-test (false) |
| `--sort-order` | `ASCENDING\|DESCENDING` | Sort order by campaign ID (default: ASCENDING) |
| `--page-size` | `<1-1000>=100` | Number of results per page (max 1000) |
| `--page-token` | `<next>` | Cursor token for next page of results |

### linkedin campaigns search

Search campaigns with multiple filters (IDs, statuses, types, campaign groups).

Beta: this command may still change.

```bash theme={null}
adside linkedin campaigns search [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--account-id` | `<id>` | LinkedIn Ad Account ID. Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |
| `--campaign-ids` | `'<json>'` | List of campaign IDs to fetch |
| `--statuses` | `'<json>'` | Filter by multiple statuses |
| `--campaign-group-ids` | `'<json>'` | Filter by multiple campaign group IDs |
| `--types` | `'<json>'` | Filter by multiple campaign types |
| `--sort-order` | `ASCENDING\|DESCENDING` | Sort order by campaign ID |
| `--page-size` | `<1-1000>=100` | Page size |
| `--page-token` | `<next>` | Cursor token for next page |

## linkedin conversion-rule

### linkedin conversion-rule get

Get one conversion rule by id, with its attribution settings, value, URL rules, associated campaigns and (for pixel rules) the Insight Tag \<img> snippet.

Beta: this command may still change.

```bash theme={null}
adside linkedin conversion-rule get --conversion-rule-id <id>
```

| Flag | Value | What it does |
| - | - | - |
| `--conversion-rule-id` (required) | `<id>` | The rule's numeric id, or the full urn:lla:llaPartnerConversion:… as it appears in a campaign's conversion list. |

## linkedin conversions

### linkedin conversions list

List the conversion rules on a LinkedIn Ad Account: name, type, method, attribution settings, conversion value and enabled status.

Beta: this command may still change.

```bash theme={null}
adside linkedin conversions list [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--account-id` | `<id>` | LinkedIn Ad Account ID. Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |
| `--start` | `<min 0>=0` | Index of the first rule to return (offset paging). |
| `--count` | `<1-1000>=100` | How many rules to return. LinkedIn defaults to 10 if unset, so this tool asks for 100; check `next_start` in the response for more. |

## linkedin creatives

### linkedin creatives get

Get a creative by ID: its status, review status, serving hold reasons — and the actual content of the ad, read from the post it points at.

Beta: this command may still change.

```bash theme={null}
adside linkedin creatives get --creative-id <id> [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--creative-id` (required) | `<id>` | Creative ID or URN (e.g. '120491345' or 'urn:li:sponsoredCreative:120491345') |
| `--account-id` | `<id>` | LinkedIn Ad Account ID. Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |

### linkedin creatives list

Search and list creatives for a LinkedIn Ad Account.

Beta: this command may still change.

```bash theme={null}
adside linkedin creatives list [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--account-id` | `<id>` | LinkedIn Ad Account ID. Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |
| `--campaign-ids` | `'<json>'` | Filter by campaign URNs or IDs |
| `--intended-statuses` | `'<json>'` | Filter by intended statuses |
| `--creative-ids` | `'<json>'` | Filter by specific creative URNs |
| `--sort-order` | `ASCENDING\|DESCENDING` | Sort order by creative ID (default: ASCENDING) |
| `--page-size` | `<1-100>=100` | Number of results per page (max 100) |
| `--page-token` | `<next>` | Cursor token for next page of results |

## linkedin demographic-insights

### linkedin demographic-insights get

Get professional demographic analytics for LinkedIn ads.

Beta: this command may still change.

```bash theme={null}
adside linkedin demographic-insights get --pivot MEMBER_COMPANY|MEMBER_COMPANY_SIZE|MEMBER_INDUSTRY|MEMBER_SENIORITY|MEMBER_JOB_TITLE|MEMBER_JOB_FUNCTION|MEMBER_COUNTRY_V2|MEMBER_REGION_V2|MEMBER_COUNTY --date-range-start '<json>' [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--pivot` (required) | `MEMBER_COMPANY\|MEMBER_COMPANY_SIZE\|MEMBER_INDUSTRY\|MEMBER_SENIORITY\|MEMBER_JOB_TITLE\|MEMBER_JOB_FUNCTION\|MEMBER_COUNTRY_V2\|MEMBER_REGION_V2\|MEMBER_COUNTY` | Professional demographic dimension to group results by |
| `--date-range-start` (required) | `'<json>'` | Start date (inclusive) |
| `--account-id` | `<id>` | LinkedIn Ad Account ID. Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |
| `--time-granularity` | `DAILY\|MONTHLY\|ALL=ALL` | Time granularity for results |
| `--date-range-end` | `'<json>'` | End date (inclusive) |
| `--campaign-ids` | `'<json>'` | Filter by campaign IDs |
| `--fields` | `'<json>'` | Specific metrics to return (max 20). Note: some metrics not available with demographic pivots. |

## linkedin lead-gen-forms

### linkedin lead-gen-forms get

Get one lead gen form with the questions it asks and the tracking parameters it appends.

Beta: this command may still change.

```bash theme={null}
adside linkedin lead-gen-forms get --lead-gen-form-id <id>
```

| Flag | Value | What it does |
| - | - | - |
| `--lead-gen-form-id` (required) | `<id>` | Numeric id of the form, or its full urn:li:adForm: URN — either is accepted. |

### linkedin lead-gen-forms list

List the lead gen forms an ad account owns.

Beta: this command may still change.

```bash theme={null}
adside linkedin lead-gen-forms list [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--account-id` | `<id>` | LinkedIn Ad Account ID (numeric). Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |
| `--start` | `<min 0>=0` | Index of the first form to return (offset paging). |
| `--count` | `<1-1000>=100` | How many forms to return. LinkedIn defaults to 10 if unset (measured: 10 served against a total of 30), so this tool asks for 100; check `next_start` in the response for more. |

## linkedin matched-audiences

### linkedin matched-audiences get

Check an audience built by uploading a contact or company list: whether LinkedIn has finished matching it, how many contacts were sent, how many members it recognized, and the urn:li:adSegment: URN to target once it is ready.

Beta: this command may still change.

```bash theme={null}
adside linkedin matched-audiences get --segment-id <id>
```

| Flag | Value | What it does |
| - | - | - |
| `--segment-id` (required) | `<id>` | The DMP segment's numeric id — the id an audience import reports when it finishes. Not the urn:li:adSegment: URN, which is a different object; use `adside linkedin ad-segment get` for that one. |

### linkedin matched-audiences list

List the audiences an ad account has built from uploaded contact or company lists, with their matching status and sizes.

Beta: this command may still change.

```bash theme={null}
adside linkedin matched-audiences list [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--account-id` | `<id>` | LinkedIn Ad Account ID (numeric). Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |
| `--start` | `<min 0>=0` | Index of the first audience to return (offset paging). |
| `--count` | `<1-1000>=100` | How many to return. LinkedIn defaults to 10 if unset, so this tool asks for 100; check `next_start` in the response for more. |

## linkedin performance

### linkedin performance compare

Compare performance across multiple campaigns side-by-side.

Beta: this command may still change.

```bash theme={null}
adside linkedin performance compare --campaign-ids '<json>' --date-range-start '<json>' [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--campaign-ids` (required) | `'<json>'` | Campaign IDs to compare |
| `--date-range-start` (required) | `'<json>'` | Start date (inclusive) |
| `--account-id` | `<id>` | LinkedIn Ad Account ID. Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |
| `--time-granularity` | `DAILY\|MONTHLY\|ALL=ALL` | Time granularity |
| `--date-range-end` | `'<json>'` | End date (inclusive) |
| `--fields` | `'<json>'` | Specific metrics to return (max 20) |

## linkedin saved-audiences

### linkedin saved-audiences get

Get one saved audience with its full targeting criteria.

Beta: this command may still change.

```bash theme={null}
adside linkedin saved-audiences get --saved-audience-id <id>
```

| Flag | Value | What it does |
| - | - | - |
| `--saved-audience-id` (required) | `<id>` | Numeric id of the saved audience (adTargetTemplate). |

### linkedin saved-audiences list

List an account's saved audiences (reusable targeting templates built in Campaign Manager).

Beta: this command may still change.

```bash theme={null}
adside linkedin saved-audiences list [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--account-id` | `<id>` | LinkedIn Ad Account ID (numeric). Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |
| `--sort-field` | `NAME\|LAST_MODIFIED\|ID=NAME` | Sort order. LinkedIn requires one; NAME is the default here. |

## linkedin targeting-entities

### linkedin targeting-entities get

Resolve targeting URNs to human-readable names.

Beta: this command may still change.

```bash theme={null}
adside linkedin targeting-entities get --urns '<json>'
```

| Flag | Value | What it does |
| - | - | - |
| `--urns` (required) | `'<json>'` | List of URNs to resolve (e.g. \['urn:li:seniority:7', 'urn:li:industry:9']) |

## linkedin targeting-facets

### linkedin targeting-facets search

Search for targeting entity values by facet type.

Beta: this command may still change.

```bash theme={null}
adside linkedin targeting-facets search --facet locations|profileLocations|industries|seniorities|titles|titlesAll|titlesPast|jobFunctions|degrees|fieldsOfStudy|staffCountRanges|interests|ageRanges|genders|interfaceLocales|companyCategory|growthRate|memberBehaviors|yearsOfExperienceRanges|revenue|employers|employersAll|employersPast|schools|skills|groups|followedCompanies|firstDegreeConnectionCompanies [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--facet` (required) | `locations\|profileLocations\|industries\|seniorities\|titles\|titlesAll\|titlesPast\|jobFunctions\|degrees\|fieldsOfStudy\|staffCountRanges\|interests\|ageRanges\|genders\|interfaceLocales\|companyCategory\|growthRate\|memberBehaviors\|yearsOfExperienceRanges\|revenue\|employers\|employersAll\|employersPast\|schools\|skills\|groups\|followedCompanies\|firstDegreeConnectionCompanies` | Targeting facet to search (e.g. locations, industries, titles). These facets REQUIRE a query — they cannot be listed: employers, employersAll, employersPast, schools, skills, groups, followedCompanies, firstDegreeConnectionCompanies. Not searchable at all, but valid in campaign targeting: audienceMatchingSegments, dynamicSegments — their values are your own audience segments, not LinkedIn attributes. |
| `--query` | `<query>` | Search text for typeahead (e.g. 'Software Engineer'). If omitted, returns all values for the facet — which only works for a listable facet. |

## linkedin video-upload

### linkedin video-upload get

Status of a video upload started with upload\_video: PENDING → PREPARING → UPLOADING → PROCESSING → AVAILABLE (or FAILED).

Beta: this command may still change.

```bash theme={null}
adside linkedin video-upload get [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--account-id` | `<id>` | LinkedIn Ad Account ID. Omit it: it defaults to the account this workspace is connected to, and any other account is refused. |
| `--wait-seconds` | `<0-240>=180` | Seconds to wait for the upload to reach AVAILABLE (or FAILED) before answering. Default 180, max 240. Leave the default: one call then usually returns the video\_urn. 0 returns the current state at once. |
| `--upload-id` | `<id>` | The upload\_id returned by upload\_video. Omit it to get the most recent upload for this workspace. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.