Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: AdWhiz Ads Manager Google Ads - Query API
description: REST API for managing Google Ads and Meta Ads accounts. All 99 tools from the AdWhiz MCP server are available as standard POST endpoints. Authenticate with your API key (Bearer aw_live_...) from https://www.adwhiz.ai/app/api-keys.
version: 1.0.0
contact:
name: AdWhiz Support
url: https://www.adwhiz.ai
email: support@adwhiz.ai
servers:
- url: https://mcp.adwhiz.ai
description: Production
tags:
- name: Google Ads - Query
description: Run custom GAQL queries
paths:
/api/v1/tools/run_gaql_query:
post:
operationId: run_gaql_query
summary: Execute a read-only GAQL query and return the results
description: 'Execute a read-only GAQL query and return the results.
Only SELECT queries are allowed — any query containing mutate-like
keywords will be rejected. Results are returned as a list of
flattened dictionaries where each key is the full field path.
Args:
customer_id: Google Ads customer ID (no dashes).
query: A valid GAQL SELECT query.
Returns:
List of result dicts, or an error dict if the query fails.
Maximum 1000 rows returned.'
tags:
- Google Ads - Query
security:
- bearerApiKey: []
requestBody:
required: true
content:
application/json:
schema:
properties:
customer_id:
title: Customer Id
type: string
query:
title: Query
type: string
required:
- customer_id
- query
title: run_gaql_queryArguments
type: object
responses:
'200':
description: Tool executed successfully. Response shape depends on the tool.
content:
application/json:
schema:
type: object
'400':
description: Invalid request body
content:
application/json:
schema:
type: object
properties:
error:
type: string
'401':
description: Missing or invalid API key
content:
application/json:
schema:
type: object
properties:
error:
type: string
'404':
description: Unknown tool name
content:
application/json:
schema:
type: object
properties:
error:
type: string
'429':
description: Monthly usage limit exceeded
content:
application/json:
schema:
type: object
properties:
error:
type: string
'500':
description: Internal server error
content:
application/json:
schema:
type: object
properties:
error:
type: string
components:
securitySchemes:
bearerApiKey:
type: http
scheme: bearer
description: 'API key from your AdWhiz dashboard (https://www.adwhiz.ai/app/api-keys). Format: aw_live_<hex>'