Google Ads Advertisers

Search public Google Ads Transparency Center advertisers and websites by name or domain. Returns advertiser IDs, domains, country, and ad-count ranges when available.

Execution model

Live request

Runtime depends on endpoint, target, pagination, rendering mode, and active plan limits.

Credit weight

Live catalog

Current weights are managed from the Data API Weights admin table and shown on pricing before use.

Parameters

Name	Type	Requirement	Description
query	string	Required	Advertiser, brand, or website search query.
region	string	Optional	Two-letter transparency region code.
limit / resultsLimit	number	Optional	Maximum records to return (1-100).
timeout_ms	number	Optional	Provider timeout in milliseconds (5000-90000).

Response fields

Field	Type	Description
success	boolean	Whether the request completed successfully.
advertisers	array	Rows with position, type, name, advertiser_id, country, domain, ads_min, and ads_max.
cursor	string	Pagination cursor when available.
time_taken	number	API response time in seconds.

Request and response

curl -X POST "https://api.datablue.dev/v1/data/google-ads/transparency/advertisers/search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "kiro beauty",
  "region": "IN",
  "resultsLimit": 20
}'

Example response

{
  "success": true,
  "source": "google_ads_transparency",
  "operation": "advertiser_search",
  "query": "kiro beauty",
  "region": "IN",
  "total_results": 1,
  "time_taken": 1.2,
  "advertisers": [
    {
      "position": 1,
      "type": "advertiser",
      "name": "Kiro Beauty",
      "advertiser_id": "AR08888592736429539329",
      "country": "IN",
      "ads_min": 1,
      "ads_max": 10
    }
  ]
}