SiteData APISiteData API

Advertiser Search API

Search Google Ads transparency advertisers by keyword.

Endpoint

GET /api/v1/ads-statistics?action=advertiserSearch&keyword=ai

Parameters

ParameterTypeRequiredDescription
actionstringYesFixed value: advertiserSearch
keywordstringYesSearch keyword

Example

GET /api/v1/ads-statistics?action=advertiserSearch&keyword=ai
Authorization: Bearer YOUR_API_KEY

Response Example

{
  "code": "ok",
  "message": "ok",
  "data": {
    "endpoint": "ads-statistics",
    "action": "advertiserSearch",
    "costCredits": 1,
    "remainingCredits": 99,
    "query": {
      "action": "advertiserSearch",
      "keyword": "ai"
    },
    "result": [
      {
        "advertiser": "ai.law",
        "country": "US",
        "countryName": "United States",
        "id": 39687
      }
    ]
  }
}

Response Fields

FieldDescription
data.endpointFixed value: ads-statistics
data.actionFixed value: advertiserSearch
data.costCreditsCredits consumed by this request
data.remainingCreditsRemaining credits after deduction
data.query.actionNormalized action name
data.query.keywordNormalized keyword
data.result[].advertiserAdvertiser name
data.result[].countryCountry code
data.result[].countryNameCountry name
data.result[].idPlain advertiser ID

On this page

Endpoint
Parameters
Example
Response Example
Response Fields
Related