Google Ads

Query Google Ads

Queries the dedicated Google Ads library. Networks, audience countries, and Google category ids map to verified google-ads-search fields.

post/v1/google-ads/query

Request

  • Base URL: https://api.trendtrack.io (the document declares no server; this is the origin it was published from)
  • URL: https://api.trendtrack.io/v1/google-ads/query
  • Auth: HTTP bearer

Request body

searchstring[]

Optional Google advertiser/domain search terms.

status'active' | 'inactive' | 'all'
networksstring[]

Google delivery networks. Values are normalized to the casing used by the Google Ads search index.

categoryIdsnumber[]

Google category ids returned by GET /v1/google-ads/facets/categories. These correspond to the app legacy niches parameter.

publishedAfterstring date-time
publishedBeforestring date-time
minDaysRunningnumber
maxDaysRunningnumber
minReachnumber
maxReachnumber
sortBy'newest' | 'reach' | 'longestRunning'
order'asc' | 'desc'
pageobject
limitobject

Example request

{
  "search": [
    "women clothing"
  ],
  "networks": [
    "shopping"
  ],
  "categoryIds": [
    24
  ],
  "audienceCountries": {
    "include": [
      "US",
      "CA"
    ],
    "exclude": [
      "BR"
    ]
  }
}

Response

Paginated Google Ads response. One returned ad is one billable ads credit.

requestIdstring required

Example response

{
  "data": [
    {
      "id": "google_123",
      "audience": {
        "countries": [
          {
            "code": "US",
            "percentage": 80
          }
        ]
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.