Insight Social
GET /v1/linkedin/ads/searchbeta

LinkedIn Ads Search API

Returns ads from the LinkedIn Ad Library matching a company, keyword, country, or date range, with each ad's copy and the advertiser behind it.

50 credits a call · cursor pagination · failed calls free · 10 free calls to start

curl "https://api.insightsocial.app/v1/linkedin/ads/search?company=microsoft" \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"
200 OKJSON
{
"success": true,
"platform": "linkedin",
"endpoint": "/v1/linkedin/ads/search",
"schema_version": "2",
"data": {
"<field>": "<value>"
},
"pagination": {
"next_cursor": "<string | null>",
"has_more": "<boolean>"
},
"unavailable": [],
"credits_used": "<integer>"
}

When to use it

Use it to find what a competitor is running, then pass a result's ad URL to ad for the complete record.

Parameters

Query parameters for GET /v1/linkedin/ads/search. Send your key in the x-api-key header.

NameRequiredDescription
companyOne of company, keyword, companyIdThe company name to search for. 'Microsoft' for example.
keywordOne of keyword, company, companyIdThe keyword to search for.
companyIdOne of companyId, company, keywordThe company id to search for.
countriesNoComma separated list of countries. Example: US,CA,MX
startDateNoStart date to search for. Format: YYYY-MM-DD
endDateNoEnd date to search for. Format: YYYY-MM-DD
cursorNoThe pagination.next_cursor from the previous page, sent back unchanged. Omit it for the first page.

Response

This endpoint returns the platform's own fields in data, in snake_case, rather than a unified post or profile. The reference page lists them.

Every field, error and example is in the LinkedIn Ads Search API reference.

How much does the LinkedIn Ads Search API cost?

50 credits per successful call.

  • Failed calls are free

    A call that errors or finds nothing costs 0 credits.

  • Know the price first

    Add dry_run=1 and the response quotes the call without making it. Nothing is charged.

  • One balance

    API calls and Chrome extension exports share the same credits, on the free plan too.

LinkedIn Ads Search API: frequently asked questions

Send GET /v1/linkedin/ads/search with either company or keyword or companyId and your key in the x-api-key header. Returns ads from the LinkedIn Ad Library matching a company, keyword, country, or date range, with each ad's copy and the advertiser behind it.