UnifAPI Docs

Search LinkedIn Ad Library ads

Searches the LinkedIn Ad Library by advertiser, keyword, country and date range. Paginate with `cursor`.

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/search

Authorization

bearerAuth
AuthorizationBearer <token>

UnifAPI API key. Provider credentials are managed by UnifAPI.

In: header

Query Parameters

company?string

Company name to search for in the LinkedIn Ad Library.

Length1 <= length <= 4096
keyword?string

Keyword or phrase to search for in LinkedIn Ad Library ads.

Length1 <= length <= 4096
company_id?string

LinkedIn company id to search for in the Ad Library.

Length1 <= length <= 4096
countries?string

Optional comma-separated list of country codes (for example US,CA,MX).

Length1 <= length <= 4096
start_date?string

Optional start date filter in YYYY-MM-DD format.

Length1 <= length
end_date?string

Optional end date filter in YYYY-MM-DD format.

Length1 <= length
cursor?string

Opaque pagination cursor from a previous response's pagination.next_cursor. Omit for the first page.

Length1 <= length <= 16384

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/search"
{  "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"          }        ]      }    }  ],  "pagination": {    "has_more": true,    "next_cursor": "string"  },  "billing": {    "credits_charged": 0,    "records_charged": 0,    "balance_remaining": 0,    "truncated_due_to_balance": true  }}