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

3 credits per record

Parameters

Field	Type	Required	Description
`google_ad_url`	string	Yes	Google Ad Transparency search URL
`limit`	int	Yes	Max items to return (max 100)

Example response

json

{
  "adUrl": "example",
  "advertiserId": "example",
  "creativeId": "example",
  "format": "example",
  "landingDomain": "example",
  "landingUrls": [],
  "lastShown": "example"
}

Code

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

Try it

LinkedIn Ad Details

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

POST

/api/v1/linkedin_ad_details

2 credits per call

Parameters

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

Example response

json

{
  "element": {
    "about": {
      "advertiserName": "UX Pilot AI",
      "advertiserUrl": "https://www.linkedin.com/company/99850535?trk=ad_library_about_ad_advertiser",
      "format": "Single Image Ad",
      "paidBy": "UX Pilot"
    },
    "id": "1215501393",
    "impressions": null,
    "targeting": null,
    "variants": [
      {
        "advertiser": {
          "headline": "Promoted",
          "imageUrl": "https://media.licdn.com/dms/image/v2/D4E0BAQF14xfiQrSfew/company-logo_100_100/B4EZwpRV9cGcAQ-/0/1770218938904/uxpilot_ai_logo?e=1784160000&v=beta&t=dAJZSufW8CcVg1PVqad0K4AQtae4qg06TbFbHfRn-bE",
          "linkedinUrl": "https://www.linkedin.com/company/99850535?trk=ad_library_ad_preview_advertiser_image",
          "name": "UX Pilot AI"
        },
        "content": {
          "ctaLabel": "Learn more",
          "description": "Paste your PRD, generate multi-step flows with your actual components, and get screens that look like your product, in seconds, not generic AI output.\n\nSee it in action today.",
          "headline": "Generate wireframes in seconds",
          "imageUrl": "https://media.licdn.com/dms/image/v2/D4D10AQHrygtedL9DNQ/image-shrink_1280/B4DZXy8bxYHIAM-/0/1743537684174/Frame1000002823png?e=2147483647&v=beta&t=_j-yK4ZU0KcFUnEBpTGGtFYJED9-EoNv1SJGfdVWy2w",
          "targetUrl": null
        },
        "creativeType": "SPONSORED_STATUS_UPDATE"
      }
    ]
  },
  "query": {
    "url": "https://www.linkedin.com/ad-library/detail/1215501393"
  },
  "status": 200
}

Code

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

Try it

LinkedIn Ad Search

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

POST

/api/v1/linkedin_ad_search

0.2 credits per record

Parameters

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

Example response

json

{
  "elements": [
    {
      "advertiser": {
        "headline": "Promoted",
        "imageUrl": "https://media.licdn.com/dms/image/v2/D5603AQEXQwoTvYzI4g/profile-displayphoto-shrink_100_100/profile-displayphoto-shrink_100_100/0/1690229902311?e=1784160000&v=beta&t=2IMeZUc8bHdZ45ltzbmgusSz1xwtt5A4cwLwkrclgGQ",
        "name": "CEO/Founder and Friend. Professional People Finder"
      },
      "content": {
        "description": "Why did I spend so much time and money building an Applicant Tracking System for small employers?\n\nBecause after 25 year…",
        "headline": "Gatekeeper - HRmango",
        "imageUrl": "https://media.licdn.com/dms/image/sync/v2/D4D27AQHZ0IA4LHmDJw/articleshare-shrink_1280_800/B56Z6BUMuzKoAY-/0/1780286017249?e=2147483647&v=beta&t=GII46uFAERO0ZuricQcwmLsTs6ilj49bf989nMPoGo4",
        "pageUrl": "https://www.linkedin.com/ad-library/detail/1440550993"
      },
      "creativeType": "SPONSORED_STATUS_UPDATE",
      "id": "1440550993"
    }
  ],
  "pagination": {
    "pageNumber": null,
    "pageSize": 1,
    "paginationToken": "1460308964-1782143461901",
    "previousElements": null,
    "totalElements": 1,
    "totalPages": 1
  },
  "query": {
    "account_owner": "example",
    "countries": "US",
    "date_option": "last-30-days",
    "keyword": "marketing automation"
  },
  "status": 200
}

Code

curl -X POST https://dev-api.richapi.ai/api/v1/linkedin_ad_search \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "keyword": "marketing automation",
  "account_owner": "example",
  "countries": "US",
  "date_option": "last-30-days",
  "start_date": "example",
  "end_date": "example",
  "pagination_token": "example",
  "search_url": "example"
}'

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

1 credit per record

Parameters

Field	Type	Required	Description
`meta_ad_url`	string	Yes	URL of the Meta Ad to scrape
`limit`	int	No	Max results to return (max 100)

Example response

json

{
  "adArchiveID": "example",
  "adStatus": "example",
  "adText": "example",
  "ctaDomain": "example",
  "pageName": "example",
  "publisherPlatforms": [],
  "startDate": "example"
}

Code

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

Try it