LinkedIn Ads CLI Skill

You have access to linkedin-ads-cli, a read-only CLI for the LinkedIn Marketing API (REST API, version 202603). Use it to query ad accounts, pull performance analytics with pivot breakdowns, inspect creatives, explore audiences and targeting facets, retrieve lead form submissions, and get budget and delivery forecasts.

Quick start

# Check if the CLI is available
linkedin-ads-cli --help

# Get authenticated user info
linkedin-ads-cli me

# List organizations you administer
linkedin-ads-cli organization-acls

# List ad accounts
linkedin-ads-cli accounts

If the CLI is not installed, install it:

npm install -g linkedin-ads-cli

Authentication

The CLI requires a LinkedIn OAuth2 Bearer token. Credentials are resolved in this order:

1. --credentials <path> flag (per-command)
2. Environment variable: LINKEDIN_ADS_ACCESS_TOKEN
3. Auto-detected file: ~/.config/linkedin-ads-cli/credentials.json

Required OAuth scopes depend on the commands used:

• r_ads -- read ad accounts and campaigns
• r_ads_reporting -- read ad analytics
• r_organization_social -- read organization data

Before running any command, verify credentials are configured by running linkedin-ads-cli me. If it fails with a credentials error, ask the user to set up authentication.

Entity hierarchy

Organization (Company Page)
 +-- Ad Account (urn:li:sponsoredAccount:XXXXX)
      +-- Campaign Group
      |    +-- Campaign
      |         +-- Creative
      +-- Matched Audience (DMP Segment)
      +-- Conversion Rule
      +-- Insight Tag
      +-- Lead Gen Form

LinkedIn uses URN format for IDs (e.g., urn:li:sponsoredAccount:123456). The CLI accepts both full URNs and plain numeric IDs for all commands that take entity IDs.

When chaining commands, extract the numeric ID from URNs (the part after the last colon). For example, organization-acls returns organization URNs like urn:li:organization:12345678 -- use 12345678 with the organization command.

Most list commands require the parent entity ID. Start with me to get your profile, then organization-acls to find organizations you manage, then accounts to find ad accounts.

Monetary values

The analytics API returns monetary fields as-is from LinkedIn. The costInLocalCurrency field is in the account's local currency and costInUsd is in USD. Both are returned as decimal string values from the API in the major currency unit (e.g. "244.85000").

Output format

All commands output pretty-printed JSON by default. Use --format compact for single-line JSON (useful for piping).

Two pagination styles exist depending on the command:

• Token-based: uses --page-size and --page-token (look for pageToken in the response for the next page)
• Offset-based: uses --count and --start (increment --start by --count for the next page)

Commands reference

User & organization discovery