# Google API: Get company ads

> Finds a verified advertiser in the Google Ads Transparency Center by company name or website domain and returns its Google ads with dates, regions, previews and ad pages. Counts may be approximate; regions and media previews are read for the first 40 ads.

Unofficial. Not affiliated with or endorsed by Google.

- Page: https://fous.com/methods/adstransparency.google.com/get-company-ads
- Method: `adstransparency.google.com/get_company_ads`, version 1
- Website: adstransparency.google.com
- Returns: advertiser name, location, ad count, ads with format, dates, regions, text, preview URL, ad page link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `country` | string | no | `"US"` | Country name or two-letter country code, for example United States or US; all means all countries. Default "all". |
| `ad_format` | string | no | `"video"` | Ad type to include, for example video. One of "all", "text", "image", "video". Default "all". |
| `advertiser` | string | yes | `"Nike"` | Company or brand name, or website domain, for example Nike or nike.com. |
| `date_range` | string | no |  | When ads were shown, for example last_30_days. One of "any_time", "last_7_days", "last_30_days". Default "any_time". |
| `max_results` | integer | no | `105` | Maximum ads to return, for example 40. Default 40. |

## Output

From a run on Oct 31, 2026, shortened. Its input:

```json
{
  "country": "US",
  "ad_format": "video",
  "advertiser": "Nike",
  "max_results": 105
}
```

Its output:

```json
{
  "ads": [
    {
      "ad_id": "CR10652972250883424257",
      "format": "video",
      "ad_text": null,
      "preview_url": "https://tpc.googlesyndication.com/simgad/6916328398620481038",
      "ad_page_link": "https://adstransparency.google.com/advertiser/AR16735076323512287233/creative/CR10652972250883424257",
      "regions_shown": [
        "United States",
        "Canada"
      ],
      "last_shown_date": "2026-09-29",
      "first_shown_date": "2026-07-07"
    },
    {
      "ad_id": "CR07320027051652546561",
      "format": "video",
      "ad_text": null,
      "preview_url": "https://tpc.googlesyndication.com/simgad/6916328398620481038",
      "ad_page_link": "https://adstransparency.google.com/advertiser/AR16735076323512287233/creative/CR07320027051652546561",
      "regions_shown": [
        "United States",
        "Canada"
      ],
      "last_shown_date": "2026-09-28",
      "first_shown_date": "2026-07-07"
    },
    {
      "ad_id": "CR02029141914422345729",
      "format": "video",
      "ad_text": null,
      "preview_url": "https://tpc.googlesyndication.com/simgad/1482435130401986799",
      "ad_page_link": "https://adstransparency.google.com/advertiser/AR16735076323512287233/creative/CR02029141914422345729",
      "regions_shown": [
        "United States"
      ],
      "last_shown_date": "2026-09-28",
      "first_shown_date": "2026-07-07"
    }
  ],
  "advertiser_id": "AR16735076323512287233",
  "advertiser_name": "Nike, Inc.",
  "total_ads_count": 100,
  "matched_advertiser": "Nike, Inc.",
  "advertiser_location": "United States",
  "advertiser_page_link": "https://adstransparency.google.com/advertiser/AR16735076323512287233"
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"adstransparency.google.com/get_company_ads","input":{"country":"US","ad_format":"video","advertiser":"Nike","max_results":105}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What video ads has Peloton been running in the United States over the last 30 days? I'd like dates and preview links.
- Pull up the Google Ads Transparency Center listing for hellofresh.com and show me their image ads shown in the UK, up to 60 of them.
- I'm doing competitor research on Allbirds — list every ad they've run in the past week, with the regions each one appeared in and the ad text.
- Check Google's ad transparency records for Duolingo: where's the advertiser based, roughly how many ads do they have, and give me the first 25 with their formats.
- Show me text ads from monday.com that ran in Germany, including when each started and stopped and a link to its ad page.

## Input schema

```json
{
  "type": "object",
  "required": [
    "advertiser"
  ],
  "properties": {
    "country": {
      "type": "string",
      "default": "all",
      "description": "Country name or two-letter country code, for example United States or US; all means all countries."
    },
    "ad_format": {
      "enum": [
        "all",
        "text",
        "image",
        "video"
      ],
      "type": "string",
      "default": "all",
      "description": "Ad type to include, for example video."
    },
    "advertiser": {
      "type": "string",
      "description": "Company or brand name, or website domain, for example Nike or nike.com."
    },
    "date_range": {
      "enum": [
        "any_time",
        "last_7_days",
        "last_30_days"
      ],
      "type": "string",
      "default": "any_time",
      "description": "When ads were shown, for example last_30_days."
    },
    "max_results": {
      "type": "integer",
      "default": 40,
      "maximum": 200,
      "minimum": 1,
      "description": "Maximum ads to return, for example 40."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "advertiser_name",
    "advertiser_location",
    "matched_advertiser",
    "advertiser_page_link",
    "total_ads_count",
    "advertiser_id",
    "ads"
  ],
  "properties": {
    "ads": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "format",
          "first_shown_date",
          "last_shown_date",
          "regions_shown",
          "ad_text",
          "preview_url",
          "ad_page_link",
          "ad_id"
        ],
        "properties": {
          "ad_id": {
            "type": "string",
            "x-fous-developer": true
          },
          "format": {
            "type": [
              "string",
              "null"
            ]
          },
          "ad_text": {
            "type": [
              "string",
              "null"
            ]
          },
          "preview_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "ad_page_link": {
            "type": "string"
          },
          "regions_shown": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            }
          },
          "last_shown_date": {
            "type": [
              "string",
              "null"
            ]
          },
          "first_shown_date": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "additionalProperties": false
      }
    },
    "advertiser_id": {
      "type": "string",
      "x-fous-developer": true
    },
    "advertiser_name": {
      "type": "string"
    },
    "total_ads_count": {
      "type": "integer"
    },
    "matched_advertiser": {
      "type": "string"
    },
    "advertiser_location": {
      "type": [
        "string",
        "null"
      ]
    },
    "advertiser_page_link": {
      "type": "string"
    }
  },
  "additionalProperties": false
}
```

## See more

- [Google API: Summarize a company's patents](https://fous.com/methods/patents.google.com/list-company-patents.md): Summarizes a company's public patents on Google Patents within filing dates (optionally narrowed by topic words): total found, filings per year, top technology areas and inventors across the 50 most recent records, and the most recent patents.
- [Google API: Search Google Flights](https://fous.com/methods/google.com/search-flights.md): Finds Google Flights options for a route and date with prices, local times, stops and emissions. Round-trip searches list outbound choices with their displayed round-trip fares.
- [Google API: Search Google News](https://fous.com/methods/news.google.com/search-news.md): Finds recent Google News articles about a company, person or topic for a country and language, in Google News order, optionally within a time window, with each article's publisher link resolved.
- [Google API: Search Google Play apps](https://fous.com/methods/play.google.com/search-apps.md): Finds Android apps on Google Play by keywords, in Play search order, with each listing's developer, star rating, price and currency for the chosen country, download range and link. Results are limited to apps shown on the public search page.
- [Google API: Get Android app listing](https://fous.com/methods/play.google.com/get-app.md): Gets a public Google Play app listing by app name or Play Store link, with developer, rating, downloads, price, what's new, descriptions and data safety highlights.
- [Google API: Get company financials](https://fous.com/methods/google.com/get-company-financials.md): Gets a company's quarterly or annual income statement, balance sheet or cash flow lines from its Google Finance quote page, with exact reported amounts and year-over-year changes.
- [Google API: Search Google Hotels](https://fous.com/methods/google.com/search-hotels.md): Finds places to stay in a city or area for given dates on Google Hotels, with nightly and total prices, hotel class, guest ratings, amenities, address and cheapest booking site. Optional filters for price, stars and rating; vacation rentals are left out. Prices and availability can change.
- [Google API: Search Chrome extensions](https://fous.com/methods/chromewebstore.google.com/search-extensions.md): Finds Chrome Web Store extensions by keywords in store order, with each listing's developer, users, rating, rating count, short description and store link. Some listings omit developer, users or ratings.
- [All Google methods](https://fous.com/methods/google.com.md)