Search LinkedIn's Ad Library
search_linkedin_adsSearch the ads LinkedIn shows in its public Ad Library, by advertiser, by words in the ad or by company id, optionally by country and date: each ad's advertiser, format, headline, text, image or video, call to action, where it leads, when it ran, its impressions range and its targeting, about 25 a page. Use this to watch what a competitor advertises. Give exactly one of advertiser or company_id or query. Costs 3 credits, cached or not; a failed call is refunded.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fresh | No | Skip the cache and fetch now. Charged normally. Not available on trial credits — buy any pack to unlock it. | |
| query | No | Words in the ad. | |
| cursor | No | The `meta.next_cursor` from the previous page. Omit for the first page. | |
| end_date | No | Only ads shown on or before this day, `YYYY-MM-DD`, before today. With `start_date`. | |
| countries | No | Only ads shown in these countries: two-letter codes, comma-separated, e.g. `US,GB`. | |
| advertiser | No | The advertiser's name, as the library searches it. It matches loosely: a person whose name contains it can appear. | |
| company_id | No | LinkedIn's numeric id for the company, `company_id` in linkedin/company: that company's ads only. | |
| start_date | No | Only ads shown on or after this day, `YYYY-MM-DD`, within the last year. With `end_date`. |