Google Ads Creatives by Advertiser ID (Ads Transparency, United States, English)

omnial/google-ads-advertiser-creatives

Given one Google Ads advertiser ID, returns the first page of its ads from the Google Ads Transparency Center (United States, English): each ad's creative ID, the advertiser's name and ID, verification flag, format (text, image or video), when it was first and last shown, its transparency-center page link, and a preview image link with size where shown (not on video ads). Also returns the total ads reported for the advertiser and the number returned.

activeper callv1

Price

Up to $0.00328 per call; you pay what the call used

The price shown is the price you pay. No monthly minimum. Top-ups start at $5.

Data source

Google Ads Transparency Center

Data from the Google Ads Transparency Center.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

agent

// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/google-ads-advertiser-creatives" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/google-ads-advertiser-creatives" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/google-ads-advertiser-creatives", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/google-ads-advertiser-creatives", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

Charge	Price
Per call	$0.00328

Updated: Oct 14, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "advertiser_ids",
    "location_code",
    "language_code"
  ],
  "properties": {
    "depth": {
      "enum": [
        10,
        40
      ],
      "type": "integer",
      "default": 40,
      "description": "How many ads to ask for: 10 (the value the tested call sent) or 40 (the default); both fetch the same single first page of up to 40."
    },
    "language_code": {
      "enum": [
        "en"
      ],
      "type": "string",
      "description": "The search language; only \"en\" (English), the one tested, is offered."
    },
    "location_code": {
      "enum": [
        2840
      ],
      "type": "integer",
      "description": "The region searched; only 2840 (United States), the one tested, is offered."
    },
    "advertiser_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^AR[0-9]+$",
        "minLength": 1
      },
      "maxItems": 1,
      "minItems": 1,
      "description": "Exactly one advertiser ID (the AR-prefixed ID an advertiser lookup returns), as a one-element list; one ID per call is what was tested."
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "url": {
                  "type": "string",
                  "description": "The ad's transparency-center page."
                },
                "title": {
                  "type": "string",
                  "description": "The advertiser's name."
                },
                "format": {
                  "type": "string",
                  "description": "The ad format: \"text\", \"image\" or \"video\"."
                },
                "verified": {
                  "type": "boolean",
                  "description": "Whether the advertiser's identity is verified."
                },
                "last_shown": {
                  "type": "string",
                  "description": "When the ad was last shown (UTC timestamp)."
                },
                "creative_id": {
                  "type": "string",
                  "description": "The ad's creative ID."
                },
                "first_shown": {
                  "type": "string",
                  "description": "When the ad was first shown (UTC timestamp)."
                },
                "advertiser_id": {
                  "type": "string",
                  "description": "The advertiser's ID."
                },
                "preview_image": {
                  "type": [
                    "object",
                    "null"
                  ],
                  "properties": {
                    "url": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "The preview image link."
                    },
                    "width": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Its width in pixels."
                    },
                    "height": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "Its height in pixels."
                    }
                  },
                  "description": "A preview image of the ad; its fields are null when none is shown."
                },
                "rank_absolute": {
                  "type": "number",
                  "description": "Position in the list, from 1."
                }
              }
            },
            "description": "The ads, in the order returned."
          },
          "items_count": {
            "type": "number",
            "description": "How many ads came back."
          },
          "se_results_count": {
            "type": "number",
            "description": "The total number of ads the transparency center reports for the advertiser."
          }
        }
      }
    }
  },
  "description": "The advertiser's ads, wrapped as `{results: [...]}` (one entry per call)."
}