Top-Rated Team
English

Google Ads API reference

The Google Ads accounts you have been given, on the same key as the LinkedIn API. Read anything Google will report — campaigns, keywords, search terms, budgets, conversions, change history — and propose changes that a person then applies. Nothing here changes an account on its own: a proposal is validated by Google and written down, it runs when somebody applies it, and what undoing it would take is written down first. The same accounts and the same record as the Google Ads agent in a project room, for anybody who would rather work from their own AI client.

At a glance #

Base URL (DSN)
https://top-rated.team/google-ads/v1
Authentication
X-API-KEY: lk_…
Price
Included in the Top-Rated Team API plan: $9 a seat a month, $7 from 100. What you spend on advertising is Google's own bill.
Trial
30 days, free

Part of the Top-Rated Team API: the same key and the same trial as the LinkedIn API, the messaging channels API and the work tracker API. Keys live in the dashboard. An account is handed to you on the rooms page, where it is also set to be read only or changed.

This touches live advertising and live spend. Propose, read the one-line summary back to whoever the account belongs to, and apply only when they have said yes. If nobody is certain, leave the proposal pending — it costs nothing sitting there, and it is what a specialist reviews.

AI agents #

Every operation below is also a tool for ChatGPT, Claude or any AI that speaks MCP, and for the agents of a project room: one address per agent, with your API key in it. Create one on the dashboard.

https://top-rated.team/google-ads/mcp/<key>
https://top-rated.team/mcp/<key>

The first has the Google Ads calls and the project rooms' own. The second is the all-in-one agent, with LinkedIn's, every messaging channel's and every work tracker's too.

Endpoint catalog #

Every operation on Google Ads, in three groups: the accounts you may work in, the changes you propose and settle, and the prompt library. Open a card for its parameters, request and response.