Formats in the Search Ads 360 Reporting API

  • Search Ads 360 API request formats vary depending on whether you're searching or requesting specific entities.

  • Searches utilize the Search Ads 360 Query Language and the SearchAds360Service for customized results.

  • Responses from SearchAds360Service include a SearchAds360Row for each matching entity, containing only the requested fields.

  • Requests for specific entities return all fields for that entity, and customer IDs must be provided as 10-digit numbers without dashes.

Request format

The request format depends on the type of request you make.

You can customize your search output by defining a search query to suit your needs. The Search Ads 360 Query Language allows you to search all resources for a list of entities that match a specific set of criteria. All requests, regardless of the entity type, are made against the SearchAds360Service. See Create search reports and Search Ads 360 Query Language to learn more.

Response format

The fields populated in the response depend on the service you use:

SearchAds360Service
The response includes one SearchAds360Row object for each entity that matches your search parameters. Each row contains one object, for example, a campaign, and includes only the fields you request in your query.
Specific services
You can only request one entity at a time by resource name. The response includes all fields for that entity.

Customer ID format

In the new API, you must specify your Customer ID as a 10-digit number (XXXXXXXXXX) without dashes.