Data catalog / ads

Ads data

Read who is running ads on LinkedIn, Google and Meta, from each platform's public ad library. Search LinkedIn ads by advertiser, keyword, country and date, open a single ad for its variants and targeting, or pull the ads behind a Google Ads Transparency or Meta Ad Library search.

In short: RichAPI has four ad-library endpoints. POST /linkedin_ad_search searches the LinkedIn Ad Library by account_owner, keyword, countries and date_option, or by a full search_url, at 0.2 credits per ad returned. POST /linkedin_ad_details returns one ad's variants, impressions by country and targeting for 2 credits per call. POST /google_ad_transparency_scraper_sync takes a Google Ads Transparency URL and a limit (max 100) at 3 credits per result. POST /meta_ads_library_scraper_sync takes a Meta Ad Library URL and a limit (max 100) at 1 credit per result. Authentication is an x-api-key header.

Last updated October 13, 2026

Ads as a buying signal

A company that pays to advertise has a budget, a message and a market it is trying to reach. LinkedIn, Google and Meta each publish the ads running on their platform, and these four endpoints read those libraries.

  • POST /linkedin_ad_search searches the LinkedIn Ad Library. Filter by advertiser (account_owner), keyword, countries (comma-separated codes, ALL by default) and date_option, or paste a whole Ad Library search as search_url.
  • POST /linkedin_ad_details opens one ad by its Ad Library URL and returns its variants, impressions by country and targeting, where LinkedIn shows them.
  • POST /google_ad_transparency_scraper_sync takes a Google Ads Transparency search URL and returns the ads, with format and geographic targeting.
  • POST /meta_ads_library_scraper_sync takes a Meta Ad Library URL and returns ads from Facebook and Instagram, with creatives and spend ranges.

Endpoints and rates

Endpoint What it does Credits Billed
/linkedin_ad_search Search LinkedIn Ad Library for active ads by advertiser, keyword, or country. 0.2 per result
/linkedin_ad_details Get full details of a specific LinkedIn ad including variants, impressions by country, and targeting. 2 per call
/google_ad_transparency_scraper_sync Scrape Google Ad Transparency reports: see active ads, creative formats, and geographic targeting. 3 per result
/meta_ads_library_scraper_sync Scrape Meta (Facebook/Instagram) Ad Library: get active ads, creatives, spend ranges, and targeting. 1 per result

Rates are read from the live OpenAPI spec. Credits are prepaid and never expire, and the price of a credit depends on your package: see pricing.

What ad data costs

The four endpoints bill differently, and the difference matters at volume. LinkedIn ad search is 0.2 credits per ad, so 200 ads cost 40 credits. Meta is 1 credit per ad. Google is 3 credits per ad, so the same 200 ads cost 600.

Google and Meta take a limit of up to 100 per call. Set it to the number you will read. A competitor with a long-running campaign can have far more ads in the library than you need to see what they are saying. One LinkedIn ad's details cost a flat 2 credits.

From an ad to a contact

An ad gives you a company. The rest of the catalog gets you to the people:

  1. Pull the ads and collapse them to advertisers.
  2. Resolve each advertiser to a company domain or LinkedIn page.
  3. Find the people who own the budget with people search or leads data.
  4. Find and verify their emails with the email finder and the email verifier.

Two playbooks walk through this end to end: Google Ads Transparency to an outbound list and Meta Ad Library to an account list. The Meta one covers the awkward step, matching a Facebook Page name to a real company.

Ad library quirks

  • Google and Meta need a URL from their own ad library. Build the search in the library's website (advertiser, region, dates), copy the URL, and pass it in. There are no keyword fields for those two.
  • For a LinkedIn custom-date-range, send start_date and end_date as YYYY-MM-DD. The other date_option values are last-30-days, current-month, current-year and last-year.
  • LinkedIn search results page with pagination_token. Pass the token from the last response to get the next page.
  • Impressions and targeting on an ad's details can come back empty when LinkedIn does not show them for that ad.

Reference

account_ownerstring · Optional
Advertiser or company name
countriesstring · Optional
Comma-separated country codes (e.g. 'US,GB') or 'ALL'
date_optionstring · Optional
Date range: last-30-days, current-month, current-year, last-year, or custom-date-range
end_datestring · Optional
End date for custom range (YYYY-MM-DD)
keywordstring · Optional
Keyword to search ads for
pagination_tokenstring · Optional
Pagination token from previous response
search_urlstring · Optional
Full LinkedIn Ad Library search URL (alternative to individual filters)
start_datestring · Optional
Start date for custom range (YYYY-MM-DD)

Request

Minimum required parameters for a ads data call.

Request
{
  "account_owner": "HubSpot",
  "countries": "US,GB",
  "date_option": "last-30-days"
}

See it in a workflow

Playbooks

Real patterns, recipes, and prompts other builders run on RichAPI

Start free with 100 credits

Developer Docs

Auth, request shape, and error handling

See Documentation

FAQ

Frequently asked questions

Read who is running ads on LinkedIn, Google and Meta, from each platform's public ad library. Search LinkedIn ads by advertiser, keyword, country and date, open a single ad for its variants and targeting, or pull the ads behind a Google Ads Transparency or Meta Ad Library search.
Every endpoint is billed from the same credit pool, at the published rate on /pricing — never a separate contract per endpoint.
Yes — the same endpoint is reachable from an MCP client (Claude, ChatGPT, Cursor, Windsurf) using the same key and credit pool. See /mcp.

Related data