social data api

Google Ads

Public ads by advertiser or domain, ad details and advertiser search, with fields tailored to each ad format.

Ads run by an advertiser	`/v1/google/company/ads`	1 request+
Ad details	`/v1/google/ad`	1 request
Find advertisers	`/v1/google/adLibrary/advertisers/search`	1 request

GET/v1/google/company/ads

Ads run by an advertiser

1 request25 requests with get_ad_details

Lists a company's public Google ads, found by domain or advertiser_id. With get_ad_details=true, every ad carries advertiserId, advertiserName, creativeId, domain, format, adUrl, firstShown, and lastShown, and the request costs 25 requests. Without it you get only advertiserId and creativeId for 1 request.

Query parameters

`domain` string	Company website domain.
`advertiser_id` string	Google advertiser ID of the company.
`topic` string	all or political; political also requires `region`, such as US or AU. `allpolitical`
`region` string	Region to search in; any region when omitted.
`start_date` string	Earliest date to include, as YYYY-MM-DD.
`end_date` string	Latest date to include, as YYYY-MM-DD.
`platform` string	Google surface the ads ran on. `google_mapsgoogle_playgoogle_searchgoogle_shoppingyoutube`
`format` string	Ad format to filter on. `textimagevideo`
`get_ad_details` string	true adds full ad details and raises the cost to 25 requests.
`cursor` string	Cursor from the previous response, used to load the next page.

curl "https://api.pandorlabs.com/v1/google/company/ads" \  -H "Authorization: Bearer $PANDORLABS_KEY"

Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "ads": [
    {
      "advertiserId": "AR01614014350098432001",
      "creativeId": "CR08567627846124568577",
      "format": "image",
      "adUrl": "https://adstransparency.google.com/advertiser/AR01614014350098432001/creative/CR08567627846124568577",
      "advertiserName": "lululemon athletica canada inc.",
      "imageUrl": null,
      "firstShown": "2026-03-11T17:08:22.000Z",
      "lastShown": "2026-05-04T17:59:12.000Z"
    }
  ],
  "cursor": "CgoAP7zmu%2FzKj6ijEhBBAgiPtk1y16J9lpkAAAAAGgn8%2BHbW%2BJylE6g%3D",
  "number_of_ads_estimate": 20000
}

GET/v1/google/ad

Ad details

1 request

Returns one Google ad's details: advertiserId, creativeId, format, firstShown, lastShown, overallImpressions, creativeRegions, regionStats with impressions per region, and variations carrying headline, description, destinationUrl, and imageUrl. For political ads where Google publishes transparency data, spend holds the currency and lower and upper amounts, and targeting lists the age, gender, and location criteria that were included or excluded. Each targeted location carries its Google criterion ID, country codes, display name, and full name. Fields Google does not publish are null. Text is read with OCR and may contain errors.

Query parameters

`url` stringrequired	Link to the ad.
`cache_max_age` string	Accept a stored response up to this age. Inside that window the answer is free and comes back with `cached: true` and a `cached_at` time; past it, the request runs live for 1 request. `1d3d7d14d30d`

curl "https://api.pandorlabs.com/v1/google/ad?url=https%3A%2F%2Fadstransparency.google.com%2Fadvertiser%2FAR01614014350098432001%2Fcreative%2FCR10449491775734153217" \  -H "Authorization: Bearer $PANDORLABS_KEY"

Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "advertiserId": "AR01614014350098432001",
  "creativeId": "CR07443539616616939521",
  "firstShown": null,
  "lastShown": "2025-06-18T18:09:00.000Z",
  "format": "text",
  "overallImpressions": {
    "min": "250000",
    "max": "300000"
  },
  "spend": {
    "currency": "USD",
    "lower": "5000",
    "upper": "6000"
  },
  "targeting": {
    "age": {
      "included": [
        "25-34"
      ],
      "excluded": [
        "18-24"
      ]
    },
    "gender": {
      "included": [
        "unknown"
      ],
      "excluded": []
    },
    "location": {
      "included": [
        {
          "criterionId": "1015229",
          "name": "West Palm Beach",
          "fullName": "West Palm Beach, Florida, United States",
          "countryCodes": [
            "US"
          ]
        }
      ],
      "excluded": []
    }
  },
  "creativeRegions": [
    {
      "regionCode": "US",
      "regionName": "United States"
    }
  ],
  "regionStats": [
    {
      "regionCode": "US",
      "regionName": "United States",
      "firstShown": null,
      "lastShown": "2025-06-18T05:00:00.000Z",
      "impressions": {},
      "platformImpressions": []
    }
  ],
  "variations": [
    {
      "destinationUrl": "shop.lululemon.com/gifts-for-all",
      "headline": "lululemonⓇ Official Site - Best Birthday Gifts",
      "description": "Find The Perfect Gifts At lululemon . We Have You Covered . Shop Online For Your Gifts . Birthday Gifts For Everyone ...",
      "allText": "Sponsored Ω lululemon shop.lululemon.com/gifts-for-all lululemonⓇ Official Site - Best Birthday Gifts Find The Perfect Gifts At lululemon . We Have You Covered . Shop Online For Your Gifts . Birthday Gifts For Everyone ...",
      "imageUrl": "https://tpc.googlesyndication.com/archive/simgad/2201045439314643090"
    }
  ]
}

GET/v1/google/adLibrary/advertisers/search

Find advertisers

1 request

Finds Google advertisers by name. Matches come back with name, advertiser_id, and region, alongside the website domains associated with them. Feed advertiser_id into the company ads lookup. The search runs in the US unless you set region to another 2-letter country code, such as AU or CA.

Query parameters

`query` stringrequired	Advertiser name to search for.
`region` string	2-letter country code; US when omitted.

curl "https://api.pandorlabs.com/v1/google/adLibrary/advertisers/search?query=lululemon" \  -H "Authorization: Bearer $PANDORLABS_KEY"

Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "advertisers": [
    {
      "name": "lululemon HK Limited",
      "advertiser_id": "AR01382517811867287553",
      "region": "HK",
      "number_of_ads_estimate": 5
    }
  ],
  "websites": [
    {
      "domain": "lululemon.de"
    }
  ]
}