API Documentation

Google Ad Transparency Scraper

Scrape Google Ad Transparency reports — see active ads, creative formats, and geographic targeting.

POST

/api/v1/google_ad_transparency_scraper_sync

Parameters

Field	Type	Required	Description
`start_url`	string	Yes	Google Ad Transparency search URL
`max_items`	integer	No	Max items to return

Response fields

Field	Type	Description
`advertiserId`	string	Advertiser ID
`creativeId`	string	Creative ID
`adUrl`	string	Ad URL
`format`	string	Ad format
`lastShown`	string	Last shown date
`landingDomain`	string	Landing domain
`landingUrls`	array	Landing URLs

Code

curl -X POST https://api.richapi.ai/api/v1/google_ad_transparency_scraper_sync \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "max_items": 10,
  "start_url": "https://adstransparency.google.com/?region=US&domain=clay.com"
}'

Try it

Meta Ads Library Scraper

Scrape Meta (Facebook/Instagram) Ad Library — get active ads, creatives, spend ranges, and targeting.

POST

/api/v1/meta_ads_library_scraper_sync

Parameters

Field	Type	Required	Description
`start_url`	string	Yes	Meta Ads Library search URL
`max_results`	integer	No	Max results to return

Response fields

Field	Type	Description
`adArchiveID`	string	Ad Archive ID
`pageName`	string	Page name
`adStatus`	string	Ad status
`adText`	string	Ad text
`publisherPlatforms`	array	Publisher platforms
`startDate`	string	Start date
`ctaDomain`	string	CTA domain

Code

curl -X POST https://api.richapi.ai/api/v1/meta_ads_library_scraper_sync \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "start_url": "https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=US&q=clay",
  "max_results": 1
}'

Try it

LinkedIn Ad Search

Search LinkedIn Ad Library for active ads by advertiser, keyword, or country.

POST

/api/v1/ad_search

Parameters

Field	Type	Required	Description
`keyword`	string	No	Keyword to search ads for
`accountOwner`	string	No	Advertiser or company name
`countries`	string	No	Comma-separated country codes (e.g. 'US,GB') or 'ALL'
`dateOption`	string	No	Date range: last-30-days, current-month, current-year, last-year, or custom-date-range
`startdate`	string	No	Start date for custom range (YYYY-MM-DD)
`enddate`	string	No	End date for custom range (YYYY-MM-DD)
`paginationToken`	string	No	Pagination token from previous response
`searchUrl`	string	No	Full LinkedIn Ad Library search URL (alternative to individual filters)

Response fields

Field	Type	Description
`elements`	array	List of matching ads
`elements[].id`	string	Ad ID
`elements[].advertiserName`	string	Advertiser name
`elements[].creativeType`	string	Ad creative type (e.g. SINGLE_IMAGE, VIDEO)
`elements[].content`	object	Ad content (headline, body, CTA, image URL)
`pagination`	object	Pagination info including paginationToken for next page

Code

curl -X POST https://api.richapi.ai/api/v1/ad_search \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "keyword": "marketing automation",
  "countries": "US",
  "dateOption": "last-30-days"
}'

Try it

LinkedIn Ad Details

Get full details of a specific LinkedIn ad including variants, impressions by country, and targeting.

POST

/api/v1/ad_details

2 credits per call

Parameters

Field	Type	Required	Description
`url`	string	Yes	LinkedIn Ad Library detail URL (e.g. https://www.linkedin.com/ad-library/detail/1215501393)

Response fields

Field	Type	Description
`element.id`	string	Ad ID
`element.variants`	array	Creative variants (advertiser, content, creativeType)
`element.about`	object	Ad metadata: format, advertiserName, paidBy, ranFrom, ranTo
`element.impressions`	object	Impression stats: total and byCountry breakdown
`element.targeting`	object	Targeting info: segments and parameters

Code

curl -X POST https://api.richapi.ai/api/v1/ad_details \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://www.linkedin.com/ad-library/detail/1215501393"
}'

Try it