v3

latestOpenAPI 3.1.02026-07-318648277.6 KB

Ads Data

Google Ads Search

Search for Google Ads run by a company to understand their advertising strategy.

post/v1/ads/google-ads-search

Request body

company_domainstring

Company domain name

company_namestring

Company name

limitinteger

Maximum number of ads to return. Because you are charged 1 credit per ad returned, this also caps the credits spent on the request. Omit to return every ad found.

Example request

{
  "company_domain": "leadmagic.io",
  "company_name": "leadmagic",
  "limit": 10
}

Response

Successful response with ads details

messagestring

credits_consumednumber

ads_countinteger

Example response

{
  "ads": [
    {
      "advertiser_id": "AR14106062795078369281",
      "creative_id": "CR14003695067076755457",
      "original_url": "https://adstransparency.google.com/advertiser/AR14106062795078369281/creative/CR14003695067076755457?region=anywhere",
      "variants": [
        {
          "content": "<img src=\"https://tpc.googlesyndication.com/archive/simgad/6399633577457746150\" height=\"173\" width=\"380\">",
          "height": 173,
          "width": 380
        }
      ],
      "start": "2024-07-03",
      "last_seen": "2025-03-06",
      "advertiser_name": "LeadMagic Inc",
      "format": "Text"
    },
    {
      "advertiser_id": "AR14106062795078369281",
      "creative_id": "CR16065875974473908225",
      "original_url": "https://adstransparency.google.com/advertiser/AR14106062795078369281/creative/CR16065875974473908225?region=anywhere",
      "variants": [
        {
          "content": "<img src=\"https://tpc.googlesyndication.com/archive/simgad/14075255850026292628\" height=\"173\" width=\"380\">",
          "height": 173,
          "width": 380
        }
      ],
      "start": "2025-02-04",
      "last_seen": "2025-03-06",
      "advertiser_name": "LeadMagic Inc",
      "format": "Text"
    }
  ],
  "credits_consumed": 2
}