traceeai.com Support Get a key

Ads

Run a Google Ads query

Read-only GAQL (SELECT … FROM … [WHERE …]) on the connected Google Ads accounts; at most 200 rows each.

POSThttps://traceeai.com/api/v1/ads/google/query

CLI:tracee ads google-query·MCP:adsaction google_query

Authorizations

Authorizationstringheaderrequired
Bearer <key>: a personal key (tracee login or Settings → Personal keys), a workspace key, or an MCP client's OAuth token. See Authentication.

Headers

Tracee-Workspacestring
For a personal key or OAuth token that reaches several workspaces: the workspace id to act on. Workspace keys don't need it.
uuid

Body

application/json

querystringrequired
The GAQL statement
up to 4,000 characters
customer_idstring
One Google Ads account id. From GET /api/v1/ads/accounts
up to 20 characters

Response

200Done.
The action's result, exactly as the MCP tool returns it to agents. A next field, when present, names the endpoint that follows up.

Run a Google Ads query

curl -X POST "https://traceeai.com/api/v1/ads/google/query" \
  -H "Authorization: Bearer $TRACEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "pricing"
  }'

{
  "…": "The action's result, as the MCP tool returns it"
}