LinkedIn Marketing API Program

https://learn.microsoft.com/en-us/linkedin/marketing/?view=li-lms-2026-01
Admin
The LinkedIn Marketing API Program provides APIs for businesses to create, manage, and report on...
Tokens:3,009
Snippets:15
Trust Score:10
Update:1 month ago
Show doc for...
Tokens:
Raw
### GET /accountIntelligence

Source: https://learn.microsoft.com/en-us/linkedin/marketing/account-intel/account-intel-api?view=li-lms-2026-01&tabs=http

Retrieves account intelligence data based on specified query parameters and filter criteria.

```APIDOC
## GET /accountIntelligence

### Description
Retrieves account intelligence data for a specified sponsored account, supporting various filtering options like lookback windows, ad segments, and campaigns.

### Method
GET

### Endpoint
https://api.linkedin.com/rest/accountIntelligence

### Query Parameters
- **q** (string) - Required - The query type, e.g., 'account'.
- **start** (integer) - Optional - The starting index for pagination.
- **count** (integer) - Optional - The number of results to return.
- **account** (string) - Required - The URN of the sponsored account.
- **filterCriteria** (string) - Optional - A string representing filter criteria such as lookbackWindow, adSegments, or campaign.
```

--------------------------------

### GET /rest/accountIntelligence

Source: https://learn.microsoft.com/en-us/linkedin/marketing/account-intel/account-intel-api?view=li-lms-2026-01&tabs=http

Retrieves account intelligence data based on query parameters such as account URN, filter criteria, and pagination settings.

```APIDOC
## GET /rest/accountIntelligence

### Description
Retrieves account-level engagement and performance metrics for a specified sponsored account.

### Method
GET

### Endpoint
/rest/accountIntelligence

### Query Parameters
- **q** (string) - Required - The query type (e.g., 'account')
- **account** (string) - Required - The URN of the sponsored account (e.g., 'urn:li:sponsoredAccount:123456789')
- **filterCriteria** (string) - Required - Filter criteria including lookback window and ad segments
- **start** (integer) - Optional - The starting index for pagination
- **count** (integer) - Optional - The number of results to return

### Response
#### Success Response (200)
- **elements** (array) - List of account intelligence objects
- **paging** (object) - Pagination metadata including count, start, total, and links
```

--------------------------------

### Query with 90-Day Lookback Window

Source: https://learn.microsoft.com/en-us/linkedin/marketing/account-intel/account-intel-api?view=li-lms-2026-01&tabs=http

Retrieves account intelligence data filtered by a 90-day lookback window.

```http
GET https://api.linkedin.com/rest/accountIntelligence?q=account&start=0&count=10&account=urn%3Ali%3AsponsoredAccount%3A123456789&filterCriteria=(lookbackWindow:LAST_90_DAYS)
```

```curl
curl -X GET 'https://api.linkedin.com/rest/accountIntelligence?q=account&start=0&count=10&account=urn%3Ali%3AsponsoredAccount%3A123456789&filterCriteria=(lookbackWindow:LAST_90_DAYS)' \
  -H 'Authorization: Bearer {INSERT_TOKEN}' \
  -H 'Linkedin-Version: {version number in the format YYYYMM}' \
  -H 'Content-Type: application/json' \
  -H 'X-Restli-Protocol-Version: 2.0.0'
```

--------------------------------

### Query with 365-Day Lookback Window

Source: https://learn.microsoft.com/en-us/linkedin/marketing/account-intel/account-intel-api?view=li-lms-2026-01&tabs=http

Retrieves account intelligence data filtered by a 365-day lookback window.

```http
GET https://api.linkedin.com/rest/accountIntelligence?q=account&start=0&count=10&account=urn%3Ali%3AsponsoredAccount%3A123456789&filterCriteria=(lookbackWindow:LAST_365_DAYS)
```

```curl
curl -X GET 'https://api.linkedin.com/rest/accountIntelligence?q=account&start=0&count=10&account=urn%3Ali%3AsponsoredAccount%3A123456789&filterCriteria=(lookbackWindow:LAST_365_DAYS)' \
  -H 'Authorization: Bearer {INSERT_TOKEN}' \
  -H 'Linkedin-Version: {version number in the format YYYYMM}' \
  -H 'Content-Type: application/json' \
  -H 'X-Restli-Protocol-Version: 2.0.0'
```

--------------------------------

### Account Intelligence API Response Samples

Source: https://learn.microsoft.com/en-us/linkedin/marketing/account-intel/account-intel-api?view=li-lms-2026-01&tabs=http

These JSON samples illustrate the structure of API responses, including company engagement metrics, paging information, and varying filter criteria.

```json
{
    "elements": [
        {
            "companyPageUrl": "https://www.linkedin.com/company/microsoft",
            "companyWebsite": "http://www.microsoft.com",
            "paidClicks": 20,
            "organicEngagements": 50,
            "companyName": "Microsoft",
            "paidLeads": 40,
            "paidEngagements": 300,
            "paidImpressions": 133,
            "organicImpressions": 50,
            "engagementLevel": "VERY_LOW",
            "paidQualifiedLeads": 5,
            "conversions": 12
        }
        // ...
    ],
    "paging": {
        "count": 10,
        "start": 0,
        "total": 30,
        "links": [
            {
                "rel": "next",
                "type": "application/json",
                "href": "/rest/accountIntelligence?q=account&filterCriteria=(lookbackWindow:LAST_90_DAYS,adSegments:List())&start=10&count=10&account=urn%3Ali%3AsponsoredAccount%3A123456789"
            }
        ]
    }
}
```

```json
{
    "elements": [
        {
            "companyPageUrl": "https://www.linkedin.com/company/microsoft",
            "companyWebsite": "http://www.microsoft.com",
            "paidClicks": 40,
            "organicEngagements": 100,
            "companyName": "Microsoft",
            "paidLeads": 80,
            "paidEngagements": 600,
            "paidImpressions": 266,
            "organicImpressions": 100,
            "engagementLevel": "VERY_LOW",
            "paidQualifiedLeads": 8,
            "conversions": 18
        }
        // ...
    ],
    "paging": {
        "count": 10,
        "start": 0,
        "total": 30,
        "links": [
            {
                "rel": "next",
                "type": "application/json",
                "href": "/rest/accountIntelligence?q=account&filterCriteria=(lookbackWindow:LAST_180_DAYS)&start=10&count=10&account=urn%3Ali%3AsponsoredAccount%3A123456789"
            }
        ]
    }
}
```

```json
{
    "elements": [
        {
            "companyPageUrl": "https://www.linkedin.com/company/microsoft",
            "companyWebsite": "http://www.microsoft.com",
            "paidClicks": 40,
            "organicEngagements": 100,
            "companyName": "Microsoft",
            "paidLeads": 80,
            "paidEngagements": 600,
            "paidImpressions": 266,
            "organicImpressions": 100,
            "engagementLevel": "VERY_LOW",
            "paidQualifiedLeads": 8,
            "conversions": 18,
            "paidVideoViews": 160
        }
        // ...
    ],
    "paging": {
        "count": 10,
        "start": 0,
        "total": 30,
        "links": [
            {
                "rel": "next",
                "type": "application/json",
                "href": "/rest/accountIntelligence?q=account&filterCriteria=(lookbackWindow:LAST_180_DAYS)&start=10&count=10&account=urn%3Ali%3AsponsoredAccount%3A123456789"
            }
        ]
    }
}
```

```json
{
    "elements": [
        {
            "companyPageUrl": "https://www.linkedin.com/company/microsoft",
            "companyWebsite": "http://www.microsoft.com",
            "paidClicks": 40,
            "organicEngagements": 100,
            "companyName": "Microsoft",
            "paidLeads": 80,
            "paidEngagements": 600,
            "paidImpressions": 266,
            "organicImpressions": 100,
            "engagementLevel": "VERY_LOW",
            "paidQualifiedLeads": 8,
            "conversions": 18,
            "paidVideoViews": 160,
            "companySize": "SIZE_10001_OR_MORE",
            "industry": "urn:li:industry:4",
            "countryCode": "US",
            "costInLocalCurrencyPerPaidQualifiedLead": 145.5
        }
        // ...
    ],
    "paging": {
        "count": 10,
        "start": 0,
        "total": 30,
        "links": [
            {
                "rel": "next",
                "type": "application/json",
                "href": "/rest/accountIntelligence?q=account&filterCriteria=(lookbackWindow:LAST_365_DAYS)&start=10&count=10&account=urn%3Ali%3AsponsoredAccount%3A123456789"
            }
        ]
    }
}
```

--------------------------------

### Query with 180-Day Lookback Window

Source: https://learn.microsoft.com/en-us/linkedin/marketing/account-intel/account-intel-api?view=li-lms-2026-01&tabs=http

Retrieves account intelligence data filtered by a 180-day lookback window.

```http
GET https://api.linkedin.com/rest/accountIntelligence?q=account&start=0&count=10&account=urn%3Ali%3AsponsoredAccount%3A123456789&filterCriteria=(lookbackWindow:LAST_180_DAYS)
```

```curl
curl -X GET 'https://api.linkedin.com/rest/accountIntelligence?q=account&start=0&count=10&account=urn%3Ali%3AsponsoredAccount%3A123456789&filterCriteria=(lookbackWindow:LAST_180_DAYS)' \
  -H 'Authorization: Bearer {INSERT_TOKEN}' \
  -H 'Linkedin-Version: {version number in the format YYYYMM}' \
  -H 'Content-Type: application/json' \
  -H 'X-Restli-Protocol-Version: 2.0.0'
```

--------------------------------

### Query with Campaign Filter

Source: https://learn.microsoft.com/en-us/linkedin/marketing/account-intel/account-intel-api?view=li-lms-2026-01&tabs=http

Retrieves account intelligence data filtered by a specific campaign.

```http
GET https://api.linkedin.com/rest/accountIntelligence?q=account&start=0&count=10&account=urn%3Ali%3AsponsoredAccount%3A123456789&filterCriteria=(lookbackWindow:LAST_30_DAYS,campaign:urn%3Ali%3AsponsoredCampaign%3A12345678)
```

```curl
curl -X GET 'https://api.linkedin.com/rest/accountIntelligence?q=account&start=0&count=10&account=urn%3Ali%3AsponsoredAccount%3A123456789&filterCriteria=(lookbackWindow:LAST_30_DAYS,campaign:urn%3Ali%3AsponsoredCampaign%3A12345678)' \
  -H 'Authorization: Bearer {INSERT_TOKEN}' \
  -H 'Linkedin-Version: {version number in the format YYYYMM}' \
  -H 'Content-Type: application/json' \
  -H 'X-Restli-Protocol-Version: 2.0.0'
```

--------------------------------

### Query with Ad Segment Filter

Source: https://learn.microsoft.com/en-us/linkedin/marketing/account-intel/account-intel-api?view=li-lms-2026-01&tabs=http

Retrieves account intelligence data filtered by specific ad segments.

```http
GET https://api.linkedin.com/rest/accountIntelligence?q=account&start=0&count=10&account=urn%3Ali%3AsponsoredAccount%3A123456789&filterCriteria=(lookbackWindow:LAST_7_DAYS,adSegments:List(urn%3Ali%3AadSegment%3A1234,urn%3Ali%3AadSegment%3A5678))
```

```curl
curl -X GET 'https://api.linkedin.com/rest/accountIntelligence?q=account&start=0&count=10&account=urn%3Ali%3AsponsoredAccount%3A123456789&filterCriteria=(lookbackWindow:LAST_7_DAYS,adSegments:List(urn%3Ali%3AadSegment%3A1234,urn%3Ali%3AadSegment%3A5678))' \
  -H 'Authorization: Bearer {INSERT_TOKEN}' \
  -H 'Linkedin-Version: {version number in the format YYYYMM}' \
  -H 'Content-Type: application/json' \
  -H 'X-Restli-Protocol-Version: 2.0.0'
```
Tokens:
Raw