Skip to main content
GET
Google Company Ads
Beta catalog endpoint. Provider activation and live verification are in progress. An unavailable operation returns HTTP 503 and uses no credits.

Authorizations

x-api-key
string
header
required

Headers

Cache-Control
string
Idempotency-Key
string

Query Parameters

domain
string
advertiser_id
string
topic
enum<string>
Available options:
all,
political
region
string
start_date
string
end_date
string
platform
enum<string>
Available options:
google_maps,
google_play,
google_search,
google_shopping,
youtube
format
enum<string>
Available options:
text,
image,
video
get_ad_details
string
cursor
string
since
string
until
string

Response

Successful response. data is specific to this operation.

success
boolean
required
platform
string
required
endpoint
string
required
credits_used
integer
required
Required range: x >= 0
credits_remaining
integer | null
required
request_id
string
required
cached
boolean
required
data
object
required

Operation-specific data. Fields depend on the endpoint and upstream response; unavailable metrics may be null.