# LinkedIn Marketing APIs (slim)

> LinkedIn's advertising APIs for campaign management, performance reporting, matched audiences, conversions and lead sync. Agents call versioned REST endpoints at api.linkedin.com/rest with a member's OAuth token, after LinkedIn approves the developer application.

- Full: https://www.anchorterminal.com/tools/linkedin-marketing-api.md (~6,900 tokens) · this version ~2,030 tokens · JSON https://www.anchorterminal.com/tools/linkedin-marketing-api.json · canonical https://www.anchorterminal.com/tools/linkedin-marketing-api
- Index: https://www.anchorterminal.com/llms.txt · API: https://www.anchorterminal.com/api/v1/index.json · Updated: 2026-10-08

**B · 62.4/100 · rank #304 of 629 · #3 in Advertising & campaign operations · not agent-ready · confidence medium**


Assessment: Monthly API versions are each supported for at least a year, with dated sunsets and a changelog, and a test ad account lets an agent create campaigns that are never served or billed. Access needs LinkedIn's approval and a member's OAuth consent, standard rate limits are not published, and no OpenAPI specification was found.

## Facts

- Kind: HTTP API · vendor: LinkedIn Corporation · category: Advertising & campaign operations · legal entity: LinkedIn Corporation · provenance 94/100
- Local only (HTTP): pypi `linkedin-api-client`, npm `linkedin-api-client`
- Auth: OAuth · pricing: Free · x402: no · licence: Proprietary service under the LinkedIn API terms of use and the Marketing API terms. The beta Python and JavaScript clients carry LinkedIn's API development software licence
- Probe metrics: not measured yet (probes haven't run)
- Surface graded: The public REST API at https://api.linkedin.com/rest (Rest.li protocol 2.0.0). No official MCP server or OpenAPI specification was found
- Products: Advertising API (campaign management and reporting), Matched Audiences, Conversions, Lead Sync, Events Management and Community Management, open to approved developers. Audience Insights and Media Planning are restricted. Company Intelligence is closed to new applications
- Access: A LinkedIn Page, a developer application and an approved product application. Advertising API starts on Development tier (read any administered account, one test ad account, edits on up to five accounts). Standard tier is requested by support ticket with a demo video, and review can take up to 30 business days
- Credentials: Three-legged OAuth 2.0 only. Scopes include r_ads, r_ads_reporting, rw_ads, rw_dmp_segments and rw_conversions. Access tokens last 60 days. Programmatic refresh tokens (365 days) are enabled for a limited set of partners
- Account roles: ACCOUNT_BILLING_ADMIN, ACCOUNT_MANAGER, CAMPAIGN_MANAGER, CREATIVE_MANAGER and VIEWER, which is read-only even with rw_ads
- Versioning: Monthly versions named YYYYMM in the `Linkedin-Version` header, latest 202609. Each is supported for at least one year. 202510 sunsets on 15 October 2026 and 202609 on 15 September 2027
- Rate limits: Daily per application and per member, reset at midnight UTC. Standard limits are not published and appear in the Developer Portal's Analytics tab after one call to the endpoint. adAnalytics allows 45 million metric values per 5 minutes and 15,000 elements a response
- Test mode: One test ad account per developer application, created with `"test": true` on POST /adAccounts. Creatives are never served or billed and are auto-rejected in review. No reporting data and no audience segment upload
- Checks before spend: Campaigns can be created as DRAFT or PAUSED. The API validates fields by objective type, returns `servingStatuses` holds, and needs an audience of at least 300 members. Creatives go through review on activation
- Reporting: adAnalytics with pivots by account, campaign, creative and member demographics. Performance metrics are near real time, demographic metrics lag 12 to 24 hours and video watch time up to 48. Performance data is kept ten years, demographics two
- Errors: message, serviceErrorCode and status on all endpoints. adAccounts, adCampaignGroups and adCampaigns add `code`, `errorDetailType` and `errorDetails` with field paths and allowed values
- Clients: linkedin-api-client on PyPI (0.3.0, 29 June 2023) and npm (0.3.0), both marked beta, under LinkedIn's API development software licence
- Status: https://www.linkedin-apistatus.com on Statuspage, shared by all LinkedIn APIs, no components listed. Latest incident 18 June 2026
- Data rules: The data storage page caps how long API data may be kept, for example one year for ad account admin and reporting data and 24-hour caching for other members' profile data

- Scores: Reliability 66, Performance pending, Schema & documentation 66, Agent ergonomics 63, Security & auth 66, Payments & pricing 30, Task success pending, Maintenance & community 64, Transparency & trust 84 · total over the 7 assessed categories
- Why: Reliability, Read with the hosted rubric, grading the public REST API. · Schema & documentation, No OpenAPI specification found. · Agent ergonomics, Field projections with `fields=` and a `fields` list on adAnalytics size responses (20). · Security & auth, Three-legged OAuth 2.0 only, with scopes per product such as r_ads, r_ads_reporting, rw_ads, rw_dmp_segments and rw_conversions. · Payments & pricing, No x402, MPP or L402 (0). · Maintenance & community, Version 202609 is the latest and the changelog page is dated 16 September 2026 (30). · Transparency & trust, Closed API under the API terms of use (13 December 2022) and the Marketing API terms (25 July 2025), naming LinkedIn Corporation or LinkedIn…
- Sources: 27, open questions: 7, both in the full twin
- Capabilities: ads.reporting, ads.campaigns, ads.budgets, ads.audiences, ads.creatives
- JSON: https://www.anchorterminal.com/api/v1/tools/linkedin-marketing-api.json
- Verify (for the vendor): the badge `https://www.anchorterminal.com/badges/linkedin-marketing-api.svg` or a link to https://www.anchorterminal.com/tools/linkedin-marketing-api from a page on the vendor's own domain, then `POST https://www.anchorterminal.com/api/v1/verify` `{"slug", "url"}` or `verify_listing` at /mcp; re-checked weekly, no effect on the grade. Snippets in the full twin.

## Before you call it

1. Send `Linkedin-Version: YYYYMM` and `X-Restli-Protocol-Version: 2.0.0` on every call. A missing or sunset version returns an error (426 for a deprecated one)
2. Create one test ad account with `"test": true` and build there first. Its creatives are auto-rejected and never billed, and it returns no reporting data
3. Create campaigns as DRAFT or PAUSED and check `servingStatuses` before activating. Some validation is postponed until activation
4. Pass `fields=` on adAnalytics. Responses stop at 15,000 elements and the endpoint throttles at 45 million metric values per 5 minutes
5. On Development tier, map each ad account to the app in the Developer Portal. Edits are limited to five accounts

## Connect

```bash
curl -X GET 'https://api.linkedin.com/rest/adAnalytics?accounts=List(urn%3Ali%3AsponsoredAccount%3A511183580)&dateRange=(start:(day:28,month:7,year:2019))&pivot=(MEMBER_COUNTRY_V2)&q=analytics&timeGranularity=ALL&fields=impressions,pivotValues' \
  -H 'Authorization: Bearer {INSERT_TOKEN}' \
  -H 'Linkedin-Version: 202609' \
  -H 'X-Restli-Protocol-Version: 2.0.0'
```
Full config and headless snippets are in the full page. Through letme (picks today, calling later): https://letme.dev/linkedin-marketing-api

## Similar tools

| Tool | Grade | Score | Shared capabilities | Slim |
| --- | --- | --- | --- | --- |
| Google Ads API | BB | 76.4 | ads.reporting, ads.campaigns, ads.budgets, ads.audiences, ads.creatives | https://www.anchorterminal.com/tools/google-ads-api.min.md |
| Meta Marketing API | B | 67.7 | ads.reporting, ads.campaigns, ads.budgets, ads.audiences, ads.creatives | https://www.anchorterminal.com/tools/meta-marketing-api.min.md |
| Microsoft Advertising API | C | 60.3 | ads.reporting, ads.campaigns, ads.budgets, ads.audiences, ads.creatives | https://www.anchorterminal.com/tools/microsoft-advertising-api.min.md |
| Amazon Ads API | C | 59 | ads.reporting, ads.campaigns, ads.budgets, ads.audiences, ads.creatives | https://www.anchorterminal.com/tools/amazon-ads-api.min.md |


## Panel reviews (0, desk reviews from public material, no calls made)