Search Ads 360 Reporting API

Name: Search Ads 360 Reporting API API
Brand: Search Ads 360 Reporting API
Availability: InStock

✓ Official Vendor SpecMarketingAdvertisingoauth25 EndpointsREST

For Agents

Run Search Ads 360 reporting queries — search rows of campaign, ad group, and conversion metrics, list accessible customers, and retrieve resource metadata for query authoring.

Quickstart

Get started with Search Ads 360 Reporting API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"run search ads 360 query"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with Search Ads 360 Reporting API API.

Run a Search Ads 360 reporting query against a customer with a SQL-like select statement

List accessible customers visible to the calling OAuth principal

Enumerate custom columns defined for a given customer

Fetch resource metadata for the SearchAds360 query language so agents can author valid queries

GET STARTED

Start building with Search Ads 360 Reporting API API

Explore with Jentic

View OpenAPI Document

The Search Ads 360 Reporting API automates the download of search marketing reports from Google's enterprise search-ads management product. Reporting is driven by a query language similar to Google Ads' GAQL: clients submit a search request specifying fields, resource, and filters, and the API streams back rows of campaign, ad group, keyword, or conversion metrics. The API also exposes endpoints to list accessible customers, retrieve resource metadata for the field schema, and read individual resource records by name.

Use Cases

Patterns agents use Search Ads 360 Reporting API API for, with concrete tasks.

★ Daily marketing performance ETL

An ETL agent pulls daily Search Ads 360 metrics — impressions, clicks, conversions, cost — into the marketing data warehouse. It calls the search endpoint with a SearchAds360 query selecting the desired fields, paginates through results, and writes them to the warehouse for dashboards. The query language matches Google Ads GAQL closely, so existing knowledge transfers.

POST /v0/customers/{+customerId}/searchAds360:search with query 'SELECT campaign.id, metrics.impressions FROM campaign WHERE segments.date DURING LAST_7_DAYS'.

Multi-customer rollup reporting

Agencies operating multiple Search Ads 360 customers need rollup reports. An agent calls listAccessibleCustomers, iterates each customer ID, and runs the same query against each, aggregating results into a single performance summary. The login-customer-id header lets the call run under the agency's manager account.

GET /v0/customers:listAccessibleCustomers, then call /v0/customers/{customerId}/searchAds360:search per ID with the same query.

Custom column inspection

Marketing operations teams maintain custom columns such as ROAS targets per advertiser. An agent enumerates customColumns for each customer, validates that the expected columns exist, and surfaces drift to ops. This protects downstream reports from silently breaking when custom columns are renamed.

GET /v0/customers/{+customerId}/customColumns and compare the returned list to the team's expected definition.

Agent-driven ads reporting through Jentic

An AI agent built on Jentic answers ad-hoc questions about Search Ads 360 performance: spend by campaign, conversion rate by device. It searches Jentic for the right operation by intent, runs the query, and summarises the result. OAuth tokens stay isolated in the Jentic vault.

Search Jentic for 'run search ads 360 query', execute /v0/customers/{customerId}/searchAds360:search with the user's natural-language-derived query.

Key Endpoints

5 endpoints — the search ads 360 reporting api automates the download of search marketing reports from google's enterprise search-ads management product.

METHOD

PATH

DESCRIPTION

POST

/v0/customers/{+customerId}/searchAds360:search

Run a SearchAds360 reporting query

GET

/v0/customers:listAccessibleCustomers

List customers accessible to the principal

GET

/v0/customers/{+customerId}/customColumns

List custom columns defined for a customer

POST

/v0/searchAds360Fields:search

Search the metadata schema for query authoring

GET

/v0/{+resourceName}

Retrieve a single resource record by name

POST

/v0/customers/{+customerId}/searchAds360:search

Run a SearchAds360 reporting query

GET

/v0/customers:listAccessibleCustomers

List customers accessible to the principal

GET

/v0/customers/{+customerId}/customColumns

List custom columns defined for a customer

POST

/v0/searchAds360Fields:search

Search the metadata schema for query authoring

GET

/v0/{+resourceName}

Retrieve a single resource record by name

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Search Ads 360 OAuth credentials and login-customer-id headers are stored encrypted in the Jentic vault. Agents receive scoped access tokens minted at execution time, with no raw refresh tokens or developer tokens leaving the vault between calls.

Intent-based discovery

Agents search Jentic with intents like 'run search ads 360 query' or 'list accessible customers' and Jentic returns the matching v0 endpoint with its full request schema, so the agent calls the correct operation without reading the SA360 reporting docs.

Time to first call

Direct integration takes 2-4 days to wire OAuth, manager-account headers, and SearchAds360 query syntax. Through Jentic the same flow is under 1 hour: search, load, execute, paginate.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

DoubleClick Search API

Earlier-generation API surface for Search Ads 360 conversions and reports.

Choose DoubleClick Search for legacy conversion uploads; choose SearchAds360 v0 for the current reporting model.

Complementary

Display & Video 360 API

Manages display and video campaigns alongside SA360 search campaigns.

Use SearchAds360 for paid search reporting; use Display & Video 360 for display, video, and audio.

Complementary

DoubleClick Bid Manager API

Programmatic media buying reporting that complements SA360 paid search.

Use Bid Manager for programmatic display reporting; use SearchAds360 for search-side metrics.

Complementary

Google Analytics Admin API

Configures the GA4 properties that ingest SA360 conversion data.

Use Analytics Admin to configure GA4; use SearchAds360 to pull SA360-side ad performance.

FAQs

Specific to using Search Ads 360 Reporting API API through Jentic.

What authentication does the Search Ads 360 Reporting API use?

It uses Google OAuth 2.0 with the doubleclicksearch scope, declared as Oauth2 and Oauth2c. Calls running under a manager account also pass a login-customer-id header. Through Jentic, OAuth credentials are held encrypted in the vault and exchanged for short-lived access tokens at execution time.

Can I run reporting queries with the SearchAds360 API?

Yes. POST /v0/customers/{+customerId}/searchAds360:search accepts a SearchAds360 query language statement — for example 'SELECT campaign.id, metrics.clicks FROM campaign WHERE segments.date DURING LAST_30_DAYS' — and returns paginated rows. The endpoint supports a pageSize parameter for bounded fetches.

What are the rate limits for the Search Ads 360 Reporting API?

Google enforces per-customer rate limits on SearchAds360 reporting; the published default is 4,800 operations per day per customer, with concurrent request limits per developer token. Pagination must use the next_page_token returned by the search endpoint to avoid duplicating row consumption against the quota.

How do I run a Search Ads 360 query through Jentic?

Search Jentic for 'run search ads 360 query', load the schema for POST /v0/customers/{+customerId}/searchAds360:search, and execute with the customerId and query string. Jentic returns the parsed rows so the agent can summarise or write them to a warehouse.

Is the Search Ads 360 Reporting API free?

The reporting API is included with Search Ads 360 entitlement; there is no separate per-call charge from Google. Costs accrue only against the Search Ads 360 product license under the customer's commercial agreement with Google.

How do I list which customers I can access?

Call GET /v0/customers:listAccessibleCustomers with the OAuth credentials of the calling user and the login-customer-id header set to the manager account if applicable. The endpoint returns the resource names of every accessible customer, which can then be passed into reporting queries.