Google Ads Advertiser Search

Search public Google Ads Transparency data with one keyword and a chosen market. After the search completes, DataForSEO can return advertiser accounts, account groups and domain matches with available details.

Your AI

Use with your AI

For tasks with several steps, continue in the AI you already use.

CodexClaude CodeCursorWindsurfCline

View instructions

Use google-ads-advertisers-task-post-dataforseo to search public Google Ads Transparency records. Reuse the existing Toolmu connection and agreed spending authorization; if setup is needed, use https://toolmu.com/SKILL.md. Check current Tool availability and execution cost. Ask only for missing search text or the ordinary name of a country or area. Check DataForSEO's current Google Ads Advertisers location list and resolve a clear place name to its supported search location internally. If the place is unclear or matches multiple locations, ask the user to choose using familiar place names; never ask them to find or enter a numeric code. Then provide both required search details. Search text must be 1–256 characters. “electric cars” and “United States” are examples, not defaults. For a literal plus or percent sign, follow the provider's %2B or %25 encoding and keep the submitted text within 256 characters.

The Tool submits the search and checks completion automatically. On success, interpret the complete returned result. Separate account groups, single accounts and domain-only matches; organize available names, advertiser IDs, account countries, Google verification flags and approximate ad counts. Keep nested accounts with their group. A search market does not fix every account's country, and a match does not establish exact business identity or bidding on the supplied text. Report counts in their own units; returned entries are not a count of unique businesses or nested accounts. Treat positions as display context. Preserve missing values, null, zero and false distinctly. Any result receipt time is not an ad update time. Explain coverage and freshness limits without inventing creatives, performance or absent details.

Task:
Find public Google Ads advertisers related to [electric cars] in [the United States]. Summarize the names, websites and approximate ad counts you find.

Paste into your connected AI's conversation.

Connection guide

Up to 0.15 credits / call

The final charge is based on confirmed usage. Unused reserved credits return to your available balance.

DataForSEO

Google Ads Advertiser Search

You receive

Receive the completed advertiser-search result for your keyword and market. Entries can represent an individual account, a group of similarly named accounts, or a domain. Available details can include names, advertiser IDs, reported account countries, Google verification flags and approximate ad counts. A domain-only entry may contain no account details. Your Agent can separate the record types and organize the available information so you can review which matches to investigate further.

Start with your task

Find public Google Ads advertisers related to [electric cars] in [the United States]. Summarize the names, websites and approximate ad counts you find.

What to know

Matches do not confirm an exact business identity or advertisers bidding on the supplied keyword. The chosen market is search context; account countries can differ. Coverage and freshness vary, and approximate ad counts do not establish a complete live creative inventory or advertising performance.

Inputs & outputs

Inspect the current inputs, availability, and maximum charge before starting.

Input schema

Input schema
Field / Path	Type	Requirement	Meaning
Search conditions`request`	`object`	Required	Required object containing the keyword and supported search-market code. Provide both fields for this task. Required fields `location_code, keyword`
Search keyword`request.keyword`	`string`	Required	Required search text, 1–256 characters. For example, apple. Matching does not guarantee an exact business identity or advertisers bidding on this text. A literal plus or percent sign needs provider-compatible %2B or %25 encoding; the submitted string must stay within 256 characters. Minimum length `1` Maximum length `256`
Search-market code`request.location_code`	`integer`	Required	Required supported location code, supplied as an integer within 1–100000000. The United States code 2840 is an example, not a default. The numeric range does not make every integer a supported market. This search context does not require every returned account to be based there. Minimum `1` Maximum `100000000`

View raw JSON

{
  "type": "object",
  "required": [
    "request"
  ],
  "properties": {
    "request": {
      "type": "object",
      "required": [
        "location_code",
        "keyword"
      ],
      "properties": {
        "keyword": {
          "type": "string",
          "maxLength": 256,
          "minLength": 1
        },
        "location_code": {
          "type": "integer",
          "maximum": 100000000,
          "minimum": 1
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

Result schema

Output fields have not been documented yet.

Additional notes

For the documented record types and available details, see DataForSEO’s Google Ads advertiser result reference. Result positions describe where entries appear in the returned search, rather than advertising performance.

Questions about this tool.

Inputs, results and details to know before running it.

Get connected

Use results as records to inspect. A match can be a similarly named account group, an individual account or a domain; it does not establish exact business identity. The query also does not prove that an advertiser is bidding on those words.

Google Ads Advertiser Search

Google Ads Advertiser Search

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Choose a topic and place

See what the results contain

Understand what a match means

Questions about this tool.

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Choose a topic and place

See what the results contain

Understand what a match means

Questions about this tool.

Does a match identify the exact business or a keyword bidder?

Are all accounts based in the market I choose?

What do Google verification and approximate ad counts mean?

How should I count entries and interpret their positions?

Do I need another Tool to retrieve results, and how current are they?