> ## Documentation Index
> Fetch the complete documentation index at: https://getanyapi.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Ads Company Ads

> Sell google_ads.company_ads on AnyAPI: the request your endpoint receives, the response it must return, and what the real-request check judges.

List the ads a company is running from the Google Ads Transparency Center by domain or advertiser ID (creative ID, format, ad URL, and first/last shown dates) with cursor pagination.

This page is the seller-facing summary of one catalog API, `google_ads.company_ads`. The transport rules that apply to every API a seller serves - signed requests, the response envelope, timeouts, and body limits - are on [the operator endpoint contract](https://getanyapi.com/docs/sell/operator-endpoint-contract.md).

## The price you compete with

AnyAPI publishes this API from **\$0.85 per 1,000 requests**. That is the price a buyer sees today, so it is the price your endpoint has to come in under to win traffic.

## The request your endpoint receives

| Field | Type | Required | What it means |
| - | - | - | - |
| `advertiserId` | string | no | Advertiser ID. Provide either domain or advertiserId. |
| `cursor` | string | no | Opaque pagination cursor from a previous response's nextCursor. |
| `domain` | string | no | Company domain (e.g. "lululemon.com"). Provide either domain or advertiserId. |
| `endDate` | string | no | Only return ads first shown on or before this date, format YYYY-MM-DD (e.g. 2024-12-31). |
| `format` | string | no | Ad format filter. One of: `text`, `image`, `video`. |
| `platform` | string | no | Platform filter. One of: `google_maps`, `google_play`, `google_search`, `google_shopping`, `youtube`. |
| `region` | string | no | Two-letter country code to scope results (e.g. "US", "AU"). |
| `startDate` | string | no | Only return ads first shown on or after this date, format YYYY-MM-DD (e.g. 2024-01-01). |
| `topic` | string | no | Search topic. "political" requires a region. One of: `all`, `political`. |

> [accordion] Full input JSON Schema
>
> ```json theme={"dark"}
> {
>   "$schema": "https://json-schema.org/draft/2020-12/schema",
>   "$id": "https://getanyapi.com/schemas/google_ads.company_ads.input.json",
>   "example": {
>     "domain": "lululemon.com"
>   },
>   "title": "Google Ads company ads input",
>   "type": "object",
>   "additionalProperties": false,
>   "properties": {
>     "domain": {
>       "type": "string",
>       "description": "Company domain (e.g. \"lululemon.com\"). Provide either domain or advertiserId."
>     },
>     "advertiserId": {
>       "type": "string",
>       "description": "Advertiser ID. Provide either domain or advertiserId."
>     },
>     "topic": {
>       "type": "string",
>       "enum": [
>         "all",
>         "political"
>       ],
>       "description": "Search topic. \"political\" requires a region."
>     },
>     "region": {
>       "type": "string",
>       "description": "Two-letter country code to scope results (e.g. \"US\", \"AU\")."
>     },
>     "platform": {
>       "type": "string",
>       "enum": [
>         "google_maps",
>         "google_play",
>         "google_search",
>         "google_shopping",
>         "youtube"
>       ],
>       "description": "Platform filter."
>     },
>     "format": {
>       "type": "string",
>       "enum": [
>         "text",
>         "image",
>         "video"
>       ],
>       "description": "Ad format filter."
>     },
>     "startDate": {
>       "type": "string",
>       "pattern": "^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$",
>       "description": "Only return ads first shown on or after this date, format YYYY-MM-DD (e.g. 2024-01-01)."
>     },
>     "endDate": {
>       "type": "string",
>       "pattern": "^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$",
>       "description": "Only return ads first shown on or before this date, format YYYY-MM-DD (e.g. 2024-12-31)."
>     },
>     "cursor": {
>       "type": "string",
>       "description": "Opaque pagination cursor from a previous response's nextCursor."
>     }
>   }
> }
> ```

## The response your endpoint must return

| Field | Type | Always present | What it means |
| - | - | - | - |
| `data` | null or object | yes | |
| `data.ads` | array | yes | |
| `data.ads[].adUrl` | string | yes | |
| `data.ads[].advertiserId` | string | yes | |
| `data.ads[].advertiserName` | string | yes | |
| `data.ads[].creativeId` | string | yes | |
| `data.ads[].domain` | string | no | Registrable domain the ad links to. |
| `data.ads[].firstShown` | string | yes | ISO 8601 date. |
| `data.ads[].format` | string | yes | |
| `data.ads[].imageUrl` | string | yes | |
| `data.ads[].lastShown` | string | yes | ISO 8601 date. |
| `data.adsEstimate` | integer | yes | Estimated total number of ads. |
| `data.nextCursor` | string or null | yes | Opaque cursor for the next page of ads, or null when this lane has no more. Pass it back as cursor to continue. |
| `found` | boolean | yes | |

Extra fields are kept, missing declared fields fail.

> [accordion] Full output JSON Schema
>
> ```json theme={"dark"}
> {
>   "$schema": "https://json-schema.org/draft/2020-12/schema",
>   "$id": "https://getanyapi.com/schemas/google_ads.company_ads.output.json",
>   "title": "Google Ads company ads output",
>   "type": "object",
>   "additionalProperties": false,
>   "required": [
>     "found",
>     "data"
>   ],
>   "properties": {
>     "found": {
>       "type": "boolean"
>     },
>     "data": {
>       "oneOf": [
>         {
>           "type": "null"
>         },
>         {
>           "type": "object",
>           "additionalProperties": false,
>           "required": [
>             "nextCursor",
>             "adsEstimate",
>             "ads"
>           ],
>           "properties": {
>             "nextCursor": {
>               "type": [
>                 "string",
>                 "null"
>               ],
>               "description": "Opaque cursor for the next page of ads, or null when this lane has no more. Pass it back as cursor to continue."
>             },
>             "adsEstimate": {
>               "type": "integer",
>               "description": "Estimated total number of ads."
>             },
>             "ads": {
>               "x-anyapi-must-populate": true,
>               "type": "array",
>               "items": {
>                 "type": "object",
>                 "required": [
>                   "advertiserId",
>                   "creativeId",
>                   "advertiserName",
>                   "format",
>                   "adUrl",
>                   "imageUrl",
>                   "firstShown",
>                   "lastShown"
>                 ],
>                 "properties": {
>                   "advertiserId": {
>                     "x-anyapi-must-populate": true,
>                     "type": "string"
>                   },
>                   "creativeId": {
>                     "x-anyapi-must-populate": true,
>                     "type": "string"
>                   },
>                   "advertiserName": {
>                     "x-anyapi-must-populate": true,
>                     "type": "string"
>                   },
>                   "format": {
>                     "x-anyapi-must-populate": true,
>                     "type": "string"
>                   },
>                   "adUrl": {
>                     "x-anyapi-domain": "adstransparency.google.com",
>                     "x-anyapi-must-populate": true,
>                     "type": "string"
>                   },
>                   "imageUrl": {
>                     "x-anyapi-domain": "googlesyndication.com",
>                     "type": "string"
>                   },
>                   "firstShown": {
>                     "type": "string",
>                     "description": "ISO 8601 date."
>                   },
>                   "lastShown": {
>                     "type": "string",
>                     "description": "ISO 8601 date."
>                   },
>                   "domain": {
>                     "type": "string",
>                     "description": "Registrable domain the ad links to."
>                   }
>                 }
>               }
>             }
>           }
>         }
>       ]
>     }
>   }
> }
> ```

## Fields that must never come back empty

* `adUrl`
* `ads`
* `advertiserId`
* `advertiserName`
* `creativeId`
* `format`

The repository marks these fields as ones every source must be able to fill. An empty value is only correct when the entity itself genuinely has nothing there.

## Not found, and how it differs from empty

When the entity does not exist, answer 2xx with the not-found shape:

```json theme={"dark"}
{
  "found": false,
  "data": null
}
```

An empty list is not a not-found: when the entity exists and has nothing to return, answer 2xx with `found: true` and an empty `ads` array.

This output schema declares no `reason` field, so `found: false` is the whole not-found answer.

## Example request

```json theme={"dark"}
{
  "domain": "lululemon.com"
}
```

The registration tests send this example to your endpoint, with the API's other test inputs. After that, the real-request check sends your endpoint real past customer inputs, and an AI reviewer compares each answer with AnyAPI's own answer to the same input.

## Next

* [The operator endpoint contract](https://getanyapi.com/docs/sell/operator-endpoint-contract.md) for signing, budgets, and the real-request check.
* [Every API open to sellers](https://getanyapi.com/docs/sell/apis/index.md).
* Want to sell an API that is not on that list? Email [support@getanyapi.com](mailto:support@getanyapi.com).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.