LinkedIn Ads

The LinkedIn Ads replica implements 17 endpoints of the Marketing API, version 202610, with Rest.li 2.0 conventions. Its key is linkedin-ads.

Connect

Variable	Value
`LINKEDIN_ADS_API_URL`	Base URL. Paths start with `/rest/`.
`LINKEDIN_ADS_TOKEN`	Fake OAuth token. Send `Authorization: Bearer <token>`.

Every request also needs LinkedIn-Version: 202610 and X-Restli-Protocol-Version: 2.0.0, and writes need Content-Type: application/json.

Node

const response = await fetch(process.env.LINKEDIN_ADS_API_URL + '/rest/adAccounts?q=search', { headers: { Authorization: 'Bearer ' + process.env.LINKEDIN_ADS_TOKEN, 'LinkedIn-Version': '202610', 'X-Restli-Protocol-Version': '2.0.0' } });
const accounts = await response.json();

This is what ancha connect linkedin-ads --lang ts prints.

Endpoints

All endpoints are partial. Any other route returns HTTP 501 with x-ancha-gap: 1.

Accounts

Method	Path
`GET`	`/rest/adAccounts`
`GET`	`/rest/adAccounts/:accountId`

Campaign groups

Method	Path
`GET`	`/rest/adAccounts/:accountId/adCampaignGroups`
`GET`	`/rest/adAccounts/:accountId/adCampaignGroups/:id`
`POST`	`/rest/adAccounts/:accountId/adCampaignGroups`
`POST`	`/rest/adAccounts/:accountId/adCampaignGroups/:id`

Campaigns

Method	Path
`GET`	`/rest/adAccounts/:accountId/adCampaigns`
`GET`	`/rest/adAccounts/:accountId/adCampaigns/:id`
`POST`	`/rest/adAccounts/:accountId/adCampaigns`
`POST`	`/rest/adAccounts/:accountId/adCampaigns/:id`

Creatives

Method	Path
`GET`	`/rest/adAccounts/:accountId/creatives`
`GET`	`/rest/adAccounts/:accountId/creatives/:id`
`POST`	`/rest/adAccounts/:accountId/creatives`
`POST`	`/rest/adAccounts/:accountId/creatives/:id`

Targeting and analytics

Method	Path
`GET`	`/rest/adTargetingFacets`
`GET`	`/rest/adTargetingEntities`
`GET`	`/rest/adAnalytics`

Behavior

Creating returns an empty 201 response with the new ID in x-restli-id.
Updating is a POST to the record with X-RestLi-Method: PARTIAL_UPDATE and a body of {"patch": {"$set": {...}}}. It returns an empty 204. Read the record again to see the result.
Finders take q=search (accounts, campaign groups, campaigns) or q=criteria (creatives) with a bounded search expression, cursor pagination and fields projection. Batch gets report per-ID errors.
Creatives reference the one seeded single-image post. New creatives stay pending review; nothing uploads an image or creates a post.
Analytics support the CAMPAIGN pivot with DAILY or ALL granularity over an explicit date range, from historical rows.

To pause campaign 701001:

curl -X POST "$LINKEDIN_ADS_API_URL/rest/adAccounts/501001/adCampaigns/701001" \
  -H "Authorization: Bearer $LINKEDIN_ADS_TOKEN" \
  -H "LinkedIn-Version: 202610" -H "X-Restli-Protocol-Version: 2.0.0" \
  -H "X-RestLi-Method: PARTIAL_UPDATE" -H "Content-Type: application/json" \
  -d '{"patch":{"$set":{"status":"PAUSED"}}}'

Starter data

The linkedin-ads-starter dataset belongs to Acme.

Record	ID	Detail
Ad account	`501001`	”Acme · US growth”, USD. The token manages it.
Ad account	`501002`	”Acme · Europe (restricted)”, EUR. Not accessible.
Campaign group	`601001`	”Q4 enterprise pipeline”, active, total budget 12000 USD.
Campaign	`701001`	”Ridgeway Robotics · operations leaders”, active, targeting Ridgeway Robotics employees in the United States.
Campaign	`701002`	”Enterprise playbook · retest”, paused.
Creative	`urn:li:sponsoredCreative:901001`	”Ridgeway operations guide”, active and approved.
Creative	`urn:li:sponsoredCreative:901002`	”Pipeline guide revision”, active, review pending.

Both creatives reference one sponsored post, “A clearer operations pipeline for Ridgeway”. Daily analytics cover 2026-10-24 and 2026-10-25, for example 14,200 impressions, 117 clicks and 132.40 USD for campaign 701001 on 2026-10-24.

Checks

LinkedIn Ads has no state checks. Use trace checks, for example { called: "POST /rest/adAccounts/501001/adCampaigns/701001" }.

Limits

Single-image sponsored content only; no image upload, video, lead forms or audiences.
Historical analytics only; no auction or delivery.

Get started

Guides

Concepts

Tools

CLI

Reference

Cloud

Help

LinkedIn Ads

Connect

Endpoints

Accounts

Campaign groups

Campaigns

Creatives

Targeting and analytics

Behavior

Starter data

Checks

Limits

​Connect

​Endpoints

​Accounts

​Campaign groups

​Campaigns

​Creatives

​Targeting and analytics

​Behavior

​Starter data

​Checks

​Limits

Connect

Endpoints

Accounts

Campaign groups

Campaigns

Creatives

Targeting and analytics

Behavior

Starter data

Checks

Limits