# Get Google Ads Transparency Center data through an API

**Use case:** 

There is no official REST API for the Google Ads Transparency Center. This task works like one: call it with a domain or advertiser ID and get the ads back as JSON in the same request. The example looks up shopify.com in the US; pass your own advertisers from Python, JavaScript, curl or any HTTP client.

## Input

```json
{
  "advertisers": [
    "shopify.com"
  ],
  "region": "US",
  "format": "all",
  "onlyNewAds": false,
  "readAdText": true,
  "maxAdsPerAdvertiser": 50,
  "ownAdsOnly": false,
  "includeDetails": false,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

## Output

```json
{
  "isNew": {
    "label": "New",
    "format": "boolean"
  },
  "advertiserName": {
    "label": "Advertiser",
    "format": "string"
  },
  "domain": {
    "label": "Domain",
    "format": "string"
  },
  "format": {
    "label": "Format",
    "format": "string"
  },
  "headline": {
    "label": "Headline",
    "format": "string"
  },
  "description": {
    "label": "Description",
    "format": "string"
  },
  "firstShown": {
    "label": "First shown",
    "format": "string"
  },
  "lastShown": {
    "label": "Last shown",
    "format": "string"
  },
  "daysShown": {
    "label": "Days shown",
    "format": "integer"
  },
  "imageUrl": {
    "label": "Image",
    "format": "string"
  },
  "adUrl": {
    "label": "Ad page",
    "format": "string"
  }
}
```

## How it works

### 1. Sign up on Apify or log in

The Google Ads Transparency Scraper & New Ads Monitor Actor is ready to run with the inputs already set for "Get Google Ads Transparency Center data through an API". [Sign up or log in](https://console.apify.com/create-task-from-example/cLGYGdPMyZqvDNgHQ) and you'll land in Apify Console with a copy of this exact task.

### 2. Start the "Get Google Ads Transparency Center data through an API" task

The Google Ads Transparency Scraper & New Ads Monitor Actor will start running based on the input automatically. You can also change all the input fields, like advertisers, country, and more, to match your specific use case.

### 3. Receive the "Get Google Ads Transparency Center data through an API" output

Monitor the progress in real time. You will be notified as soon as your dataset is complete and ready for review. Each result includes data such as new, advertiser, domain, and more.

### 4. Integrate into your workflow

The final output is delivered in JSON, CSV, or Excel format, ready to be plugged into your workflow. You can also [run the "Get Google Ads Transparency Center data through an API" task via API](https://apify.com/babymum7/google-ads-monitor.md).

## FAQ

### Which endpoint returns the ads in one request?

POST the Transparency Center API task's input to the run-sync-get-dataset-items endpoint of the Apify API with your token. The response body is the list of ads as JSON.

### Do I need a Google API key?

No. The Transparency Center API task reads the public Ads Transparency Center, so you only need an Apify API token. No Google Ads account or Google key is involved.

### How much does this task cost to run?

The Transparency Center API task is billed per ad returned: 0.0015 USD per ad, or 1.50 USD per 1,000 ads. A scheduled run that finds no new ads costs nothing for ads.

### Can I run it on a schedule or through the API?

Yes. Save the Transparency Center API task to your account, add a daily or weekly schedule in Apify Console, or start it from the Apify API, Make, Zapier or n8n with the same input.

## About this Actor

This example demonstrates how to use [Google Ads Transparency Scraper & New Ads Monitor](https://apify.com/babymum7/google-ads-monitor.md) with a specific input configuration. Visit the [Actor detail page](https://apify.com/babymum7/google-ads-monitor.md) to learn more, explore other use cases, and run it yourself.


## How to integrate an Actor?

This Task's input is already configured above. Use it as-is rather than inventing a new one.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For full API examples (JavaScript, Python, CLI, MCP, OpenAPI), see this Task's Actor page: https://apify.com/babymum7/google-ads-monitor.md

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).