linkedin

Ads › Search

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.

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

50 credits per call.

Paginates by cursor: see Pagination.

get/v1/linkedin/ads/search

Request

  • Base URL: https://api.insightsocial.app
  • URL: https://api.insightsocial.app/v1/linkedin/ads/search
  • Auth: API key in header x-api-key

Query parameters

companystring
Example:microsoft

The company name to search for. 'Microsoft' for example. Provide at least one of: company, keyword, companyId.

keywordstring

The keyword to search for. Provide at least one of: company, keyword, companyId.

companyIdstring

The company id to search for. Provide at least one of: company, keyword, companyId.

countriesstring

Comma separated list of countries. Example: US,CA,MX

startDatestring

Start date to search for. Format: YYYY-MM-DD

endDatestring

End date to search for. Format: YYYY-MM-DD

cursorstring

The pagination.next_cursor from the previous page, sent back unchanged. Omit it for the first page.

dry_run'1'

Set to 1 to get the price of this call without making it: data.dry_run carries credits_min and credits_max. Nothing is charged.

Response

Success.

successtrue required
platformstring required
endpointstring required
schema_version'2' required
dataConventionsData required
unavailablestring[] required
credits_usedinteger required
credits_remaininginteger required
request_idstring required
cachedboolean required
idempotent_replayboolean required
charge_reasonstring required
free_callboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.