UnifAPI Docs

Get a LinkedIn Ad Library ad

Returns one ad from the LinkedIn Ad Library by id: advertiser, creative, format, run dates and targeting. Returns `not_found` when the ad does not exist.

Pricing — $ · min $0.003

Minimum 3 credits ($0.003) per call. Records returned above the minimum bill 1 credit ($0.001) each.

GET
/linkedin/ads/{id}

Authorization

bearerAuth
AuthorizationBearer <token>

UnifAPI API key. Provider credentials are managed by UnifAPI.

In: header

Path Parameters

id*string

LinkedIn Ad Library ad id, as in linkedin.com/ad-library/detail/{id}.

Length1 <= length <= 500

Header Parameters

Unifapi-Version?"2026-07-01"

Pin the API version an integration was built against (date-based, e.g. 2026-07-01). Omit to use the current version. Public URL paths stay stable and unversioned; breaking changes ship under a new dated version and are announced with Deprecation and Sunset response headers. The served version is echoed in every response's Unifapi-Version header. Policy: https://unifapi.com/versioning.md

Default"2026-07-01"

Value in

  • "2026-07-01"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/linkedin/ads/string"
{  "request_id": "string",  "data": {    "id": "string",    "url": "string",    "description": "string",    "headline": "string",    "ad_type": "string",    "creative_type": "string",    "poster": "string",    "poster_title": "string",    "promoted_by": "string",    "advertiser": {      "name": "string",      "page_url": "string",      "logo_url": "string"    },    "targeting": {      "language": "string",      "location": "string",      "company": "string",      "audience": "string"    },    "creative": {      "image_url": "string",      "video_url": "string",      "carousel_image_urls": [        "string"      ],      "cta": "string",      "destination_url": "string"    },    "duration": {      "label": "string",      "started_at": 0,      "ended_at": 0    },    "impressions": {      "total": "string",      "by_country": [        {          "country": "string",          "share": "string"        }      ]    }  },  "billing": {    "credits_charged": 0,    "records_charged": 0,    "balance_remaining": 0,    "truncated_due_to_balance": true  }}