Google Ads Advertisers Endpoint
Find an advertiser ID before requesting its creative library.
Getting Started
Send your API key as a bearer token. Start with the smallest request below.
Find Advertisers
Search by brand or domain with query.
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",
"limit": 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
}
]
}Region and Results
Set Region and Limit
Set the two-letter region and a limit from 1 to 100; resultsLimit is an alias.
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": "example.com",
"region": "US",
"limit": 40
}'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
}
]
}Request Controls
Set Provider Timeout
Set timeout_ms from 5,000 to 90,000 milliseconds.
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",
"timeout_ms": 45000
}'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
}
]
}Response
Use advertisers[].advertiser_id as the source for the creatives endpoint.
Error Handling
Handle 401 for authentication, 422 for invalid input, 429 for limits, and retry only transient failures.