Google Ads

getAdsByAdvertiser

2 credits per call

Retrieve ad creatives for a specific advertiser ID from Google's Ads Transparency Center. Use advertiser IDs from the searchAds tool.

Try it

Open in playground
kirha tools run googleads_getAdsByAdvertiser \
  --input '{
    "advertiserId": "<advertiserId>"
  }'

Uses the key saved by kirha auth login.

  • advertiserIdstring, required

    From searchAds tool, starts with 'AR'

  • endDatestring

    YYYY-MM-DD format, e.g., '2024-01-31'

  • formatstring

    One of text, image, video

  • numResultsnumber, default 10, 1 to 100
  • platformstring

    One of PLAY, MAPS, SEARCH, SHOPPING, YOUTUBE

  • politicalAdsboolean

    Requires region

  • regionstring

    One of anywhere, AR, AU, AT, BE, BR, CA, CL, CN, CO, CZ, DK, EC, EG, FI, FR, DE, GR, HK, HU, IN, ID, IE, IL, IT, JP, KR, MY, MX, NL, NZ, NO, PK, PE, PH, PL, PT, RO, SA, SG, ZA, ES, SE, CH, TW, TH, TR, AE, GB, US, VN

  • startDatestring

    YYYY-MM-DD format, e.g., '2024-01-01'