Search LinkedIn Ad Library ads
Search LinkedIn Ad Library ads by company, keyword, or company id.
Headers
Get your API keyAPI key (`sfk_...`)
Company name to search for in the LinkedIn Ad Library.
min 1 chars · max 4096 chars
Keyword or phrase to search for in LinkedIn Ad Library ads.
min 1 chars · max 4096 chars
LinkedIn company id to search for in the Ad Library.
min 1 chars · max 4096 chars
Optional comma-separated list of country codes (for example US,CA,MX).
min 1 chars · max 4096 chars
Optional start date filter in YYYY-MM-DD format.
pattern: ^\d{4}-\d{2}-\d{2}$
Optional end date filter in YYYY-MM-DD format.
pattern: ^\d{4}-\d{2}-\d{2}$
Opaque pagination cursor from a previous response.
min 1 chars
Endpoint-specific response payload.
Ads returned for the requested search. This array may be empty when no ads match the filters.
Stable identifier for the ad.
min 1 chars
Public LinkedIn Ad Library URL for this ad when available.
Primary ad body text when available.
Ad headline when available.
Ad format type when available.
Poster name shown on the ad when available.
Poster title shown on the ad when available.
Promoted-by attribution when available.
Advertiser summary for this ad.
Advertiser display name when available.
Public LinkedIn company page URL when available.
Targeting summary for this ad.
Language targeting summary when available.
Location targeting summary when available.
Company targeting summary when available.
Audience targeting summary when available.
Creative content for this ad.
Primary image URL when available.
Primary video URL when available.
Carousel image URLs when available.
min 1 chars
Call-to-action label when available.
Destination URL when available.
Duration metadata for this ad.
Human-readable ad duration label when available.
ISO-8601 timestamp for when the ad started, when available.
ISO-8601 timestamp for when the ad ended, when available.
Impressions metadata for this ad.
Total impressions label when available.
Impressions share broken down by country when available.
Country name or code.
min 1 chars
Share of impressions attributed to this country.
min 1 chars
Pagination information for the current response.
Cursor to pass as `cursor` in the next request when `hasMore` is true; otherwise null.
Whether another page of ads can be requested.
Total number of matching ads when available.
≥ 0
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/linkedin/ad-library/ads/search?company=microsoft" \
-H "x-api-key: YOUR_API_KEY"Responses
LinkedIn Ad Library ads matching the requested search.