API Documentation

Title Search API

Search Google Ads transparency domains by ad title keyword.

Test API

Endpoint

GET https://api.goanyapi.com/api/v1/ads-statistics?action=titleSearch&keyword=ai&startDay=20260122&endDay=20260321&page=0&size=10

With the current configuration, each successful request costs 5 credits.

Parameters

ParameterTypeRequiredDescription
actionstringYesFixed value: titleSearch
keywordstringYesSearch keyword
startDaystringYesDate in YYYYMMDD or YYYY-MM-DD
endDaystringYesDate in YYYYMMDD or YYYY-MM-DD
pageintegerNoZero-based page number; default 0
sizeintegerNoPage size from 1 to 100; default 10

Example

GET /api/v1/ads-statistics?action=titleSearch&keyword=ai&startDay=20260122&endDay=20260321&page=0&size=10
Authorization: Bearer YOUR_API_KEY

Response Example

{
  "code": "ok",
  "message": "ok",
  "data": {
    "endpoint": "ads-statistics",
    "action": "titleSearch",
    "costCredits": 2,
    "remainingCredits": 98,
    "query": {
      "action": "titleSearch",
      "keyword": "ai",
      "startDay": "20260122",
      "endDay": "20260321",
      "page": "0",
      "size": "10"
    },
    "result": {
      "items": [
        {
          "hostId": 598,
          "host": "apps.apple.com",
          "domain": "apple.com",
          "advertisers": [
            {
              "id": 42,
              "advertiser": "Example Advertiser",
              "country": "US",
              "countryName": "United States",
              "adCount": 7
            }
          ]
        }
      ],
      "page": 0,
      "size": 10,
      "totalHosts": 125,
      "totalPages": 13,
      "hasMore": true
    }
  }
}

Response Fields

FieldDescription
data.endpointFixed value: ads-statistics
data.actionFixed value: titleSearch
data.costCreditsCredits consumed by this request
data.remainingCreditsRemaining credits after deduction
data.query.actionNormalized action name
data.query.keywordNormalized keyword
data.query.startDayNormalized start date
data.query.endDayNormalized end date
data.query.pageNormalized page string
data.query.sizeNormalized page-size string
data.result.items[]Domains on the requested page
data.result.items[].hostIdPlain host ID
data.result.items[].hostMatched host
data.result.items[].domainRegistrable domain
data.result.items[].advertisersAdvertiser summaries for the host
data.result.items[].advertisers[].idPlain advertiser ID
data.result.items[].advertisers[].advertiserAdvertiser name
data.result.items[].advertisers[].countryAdvertiser country code
data.result.items[].advertisers[].countryNameAdvertiser country name
data.result.items[].advertisers[].adCountMatching ad count
data.result.pageCurrent zero-based page
data.result.sizeRequested page size
data.result.totalHostsTotal matching host count
data.result.totalPagesTotal page count
data.result.hasMoreWhether another page is available