Skip to main content
POST
Get Google Ad Library Advertiser Search

Google Ad Library Advertiser Search

The endpoint returns the complete result set produced by the search and bills the actual number of stored advertisers.

Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null.

Completed Task Response

Use with MCP and CLI

The endpoint uses the asynchronous task flow and returns a task_id. Poll the task endpoint to read normalized results.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
query
string
required

Search query.

Minimum string length: 1
region
string
Minimum string length: 1

Response

200 - application/json

Task accepted

code
integer
data
object