POST /linkedin_ad_search • Credits: 0.2 credit per ad returned

LinkedIn Ad Search finds ads in the public LinkedIn Ad Library. Send a POST request with a keyword, an advertiser name, a country list or a date range. The response holds one page of up to 24 ads with the headline, the image, the advertiser and the detail URL. Each call costs 0.2 credit for every ad in the elements array.

Every LinkedIn ad is public data. LinkedIn publishes each one in the LinkedIn Ad Library, and LinkedIn Ad Search reads that library through RichAPI. The endpoint accepts a keyword, an advertiser name, a country list, a date range or a full ad library search URL. It returns one page of matched ads in a single synchronous response. Sales teams and product teams use the endpoint to see which ads a competitor runs, and what message each ad carries. To read the creative variants, the impression counts and the targeting of one ad, send the ad detail URL to LinkedIn Ad Details.

CAUTION: LinkedIn Ad Search accepts POST only. A GET request returns status 405 with the error linkedin_ad_search only supports POST.

CAUTION: Each ad in the elements array costs 0.2 credit. A full page of 24 ads costs 4.8 credits.

Every LinkedIn Ad Search parameter goes in the JSON request body. Every parameter is optional, and each one narrows the search.

CAUTION: LinkedIn Ad Search rejects an unknown body field with status 400 and the error Unknown input field(s). Use the parameter names in the table above, character for character.

The date_option parameter accepts five values. Send one value per request.

If you send custom-date-range, send start_date and end_date as well.

The search_url parameter takes a full LinkedIn Ad Library search URL. Build the search in the LinkedIn Ad Library, copy the URL from the browser, then send it as search_url.

CAUTION: The search_url parameter replaces the individual filters. Send search_url alone, or send the individual filters alone.

No. Your request is always a POST request with the body names in the table above.

The block below is an example response. It shows one ad from a page of 24.

The top level of the LinkedIn Ad Search response holds four fields.

Each item in the elements array holds four fields.

The content object holds four fields.

The advertiser object holds three fields.

The pagination object holds six fields.

LinkedIn Ad Search returns up to 24 ads per page, and one call returns one page. The endpoint pages by token, not by page number.

CAUTION: Every page costs credits. To walk 10 pages of 24 ads, you pay for 240 ads, that is 48 credits. Narrow the filters before you walk many pages.

LinkedIn Ad Search answers the competitive question directly, because the LinkedIn Ad Library is public. Follow these steps.

To compare two competitors, send one request per company name and compare the two elements arrays. To track a message instead of a company, send keyword with the phrase, and leave account_owner empty.

LinkedIn Ad Search finds the ads. LinkedIn Ad Details reads one of those ads in full. The two endpoints work as a pair, and the content.pageUrl field joins them.

To go from a search to the audience of one ad, follow these steps.

The element.targeting field and the element.impressions field can hold null, because LinkedIn does not publish both values for every ad.

CAUTION:LinkedIn Ad Details costs 2 credits per call. One search page of 24 ads costs 4.8 credits, and 5 detail calls cost 10 credits more. The pair costs 14.8 credits, that is $0.296.

LinkedIn Ad Search charges no base fee per call. It charges 0.2 credit for each ad in the elements array. At $0.02 a credit, the rate on the 1,000 and 5,000 credit packs, one ad costs $0.004. Larger packs cost less per credit. A full page of 24 ads costs 4.8 credits, and 4.8 credits cost $0.096.

RichAPI reserves 4.8 credits at the start of each call. That reservation covers one full page of 24 ads. RichAPI then charges for the real number of ads in elements and releases the rest of the reservation. A call that matches no ad returns an empty elements array and costs 0 credits. A failed call costs no credit.

An error response holds an error field with a text message.

For a retry loop, wait 1 second, then 2 seconds, then 4 seconds between attempts.

The LinkedIn Ad Search API needs at least one filter in the JSON request body. The filters are keyword, account_owner, countries, date_option, start_date, end_date and search_url.

The LinkedIn Ad Search API costs 0.2 credit for each ad that it returns, and it charges no base fee per call. A full page of 24 ads costs 4.8 credits, which is $0.096 at $0.02 a credit.

One LinkedIn Ad Search call returns up to 24 ads, which is one page. To read the next 24 ads, send the same filters again. Set pagination_token to the pagination.paginationToken value of the previous response.

The LinkedIn Ad Search API uses POST, and every parameter goes in the JSON request body. A GET request returns status 405 with the error linkedin_ad_search only supports POST.

Send a LinkedIn Ad Search request. Set account_owner to the competitor company name, and set date_option to the period that you track. Read pagination.totalElements for the full count, then page through the results with pagination_token.

LinkedIn Ad Search returns no targeting data. Send content.pageUrl from the search result to LinkedIn Ad Details as the ad_url parameter. Read the element.targeting object of that response.

No. A LinkedIn Ad Search call that returns an empty elements array costs 0 credits. RichAPI charges 0.2 credit per returned ad and no base fee per call.