Google Ads Transparency contains valuable data -- top_ads, bottom_ads, ad headlines, destination URLs, and more. Scraping this data directly means dealing with anti-bot detection, CAPTCHAs, IP rotation, and constantly breaking selectors. The Scavio API handles all of that and returns clean, structured JSON from a single POST request.
This tutorial shows you how to scrape Google Ads Transparency using cURL and the Scavio API. By the end, you will have a working cURL script that fetches real-time Google Ads Transparency data and parses the results.
Prerequisites
- A terminal with cURL installed (pre-installed on macOS, Linux, and Windows 10+)
- A Scavio API key (free tier includes 50 credits on signup -- no credit card required)
Step 1: Install Dependencies
curl is built into cURL, so there is nothing to install.
# cURL is pre-installed on macOS, Linux, and Windows 10+Step 2: Make Your First Google Ads Transparency Search
Send a POST request to the Scavio Google Ads Transparency API endpoint with your query. The API returns structured JSON with top_ads, bottom_ads, ad headlines, and more.
# Scavio has no Ads Transparency endpoint. This searches the public Ads Transparency
# Center pages through Google, which returns pages about the advertiser rather than the ad
# creatives themselves. For live ad copy on a keyword, read the top_ads and bottom_ads
# blocks of a POST /api/v2/google response instead.
curl -X POST "https://api.scavio.dev/api/v2/google" \
-H "Authorization: Bearer sk_live_your_key" \
-H "Content-Type: application/json" \
-d '{"query":"google ads transparency center notion"}'Step 3: Example Response
The API returns structured JSON. Here is an example response for a Google Ads Transparency search:
{
"search_parameters": { "q": "cold brew coffee", "hl": "en", "gl": "us" },
"organic_results": [
{
"position": 1,
"title": "how do you guys make cold brew? : r/Coffee",
"link": "https://www.reddit.com/r/Coffee/comments/oi7rm7/how_do_you_guys_make_cold_brew/",
"snippet": "i wanna learn how to make cold brew coffee but theres a lot of ways...",
"source": "Reddit"
}
],
"related_searches": [{ "query": "cold brew ratio", "link": "https://www.google.com/search?q=cold+brew+ratio" }],
"response_time": 2841,
"credits_used": 1,
"credits_remaining": 4821
}Every field is structured and typed -- no HTML parsing, no CSS selectors, no regex extraction. Your cURL code can access any field directly.
Step 4: Full Working Example
Here is a complete, runnable cURL script that searches Google Ads Transparency and prints the results:
#!/bin/bash
# Search Google Ads Transparency data with the Scavio API.
# POST /api/v2/google - rows come back under organic_results.
# Scavio has no Ads Transparency endpoint. This searches the public Ads Transparency
# Center pages through Google, which returns pages about the advertiser rather than the ad
# creatives themselves. For live ad copy on a keyword, read the top_ads and bottom_ads
# blocks of a POST /api/v2/google response instead.
SCAVIO_API_KEY="${SCAVIO_API_KEY:-sk_live_your_key}"
INPUT="${1:-google ads transparency center notion}"
curl -s -X POST "https://api.scavio.dev/api/v2/google" \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"query\":\"$INPUT\"}" | python3 -m json.toolWhy Use Scavio Instead of Scraping Google Ads Transparency Directly?
- No proxy management. Direct scraping requires rotating proxies to avoid IP bans. Scavio handles all of this server-side.
- No CAPTCHA solving. Google Ads Transparency aggressively blocks automated requests. Scavio returns clean data every time.
- Structured JSON output. No HTML parsing or CSS selector maintenance. Get typed, consistent data from every request.
- Multi-platform in one API. Search Google, Amazon, YouTube, and Walmart from the same API key with the same authentication pattern.
- Free tier included. 50 credits on signup with no credit card required. Each search costs 1 credit.