# Google Ads Scraper (`scraper-engine/google-ads-scraper`) Actor Scrape Google Ads results from any keyword. This actor extracts ad titles, descriptions, URLs, sitelinks, and ranking positions. Perfect for competitor research, PPC analysis, SERP monitoring, and campaign optimization. - **URL**: https://apify.com/scraper-engine/google-ads-scraper.md - **Developed by:** [Scraper Engine](https://apify.com/scraper-engine) (community) - **Categories:** Automation, Lead generation, Social media - **Stats:** 5 total users, 1 monthly users, 100.0% runs succeeded, 2 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing $19.99/month + usage To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### 🚀 What Does a Google Ads Scraper Do? A Google Ads Scraper 🕵️‍♂️ is a powerful automation tool that extracts advertising data from Google Ads, the Google Ads Transparency Center, and the Google Ad Library. It gathers ad creatives, keywords, spend insights, targeting details, and more—helping marketers, researchers, and businesses make smarter decisions. Using a Google Ads Scraper API or platforms like Google Ads Scraper Apify, you can pull structured ad intelligence in seconds. This saves hours of manual research and unlocks competitive insights at scale. From analyzing your competitor’s campaigns to discovering keyword trends and investigating policy compliance, a scraper boosts your SEO and marketing strategy. It’s also useful for research workflows such as analyzing Google Ads Transparency Center data, a common topic across GitHub repositories like google ads scraper github or google ads transparency scraper github. * * * ### 🛠️ Support and Feedback - 🐞 **Bug reports:** Open a ticket in the repository **Issues** section - ✨ **Custom solutions or feature requests:** Contact our team 📧 **Email:** dev.scraperengine@gmail.com ### 📊 What Google Ads Scraper Can I Extract? Below is a clean, visual table outlining the main data points you can extract using a Google Ads Scraper 🔍: | Data Type Extracted | Description | | --- | --- | | Ad Headlines | Primary message used in the Google ad | | Ad Descriptions | Supporting ad copy | | Display URL | Visible URL shown in the ad | | Final URL | Landing page destination | | Keywords | Search terms associated with ads | | Advertiser Info | Brand, ID, domain, or profile | | Transparency Data | Info from Google Ads Transparency Center | | Ad Creatives | Images, text, videos | | Impressions / Metrics | Visibility insights when available | | Ad Run Dates | Start, end, and active status | | Location Targeting | Countries/regions targeted by the advertiser | * * * #### ⭐ Key Features of Google Ads Scraper Here are the most powerful features that make the Google Ads Scraper an essential tool for marketers, researchers, and ad analysts: * 🔍 Transparency Center Scraping Pull rich data from the Google Ads Transparency Center, including ad details, advertiser identity, impression ranges, policies, and more. * 📚 Google Ads Library Scraper Capabilities This scraper acts as a complete Google Ads Library Scraper, delivering searchable ad archives with structured output. * ⚡ Bulk Extraction at Scale Whether you need 10 ads or 100,000 ads, the scraper handles large datasets effortlessly—ideal for agencies and research teams. * 🔗 Integrations & API Support Works seamlessly with automation tools and supports use cases similar to google ads scraper api or scrape google ads python scripts. * 🎨 Creative & Asset Data Extraction Extract images, video metadata, display URLs, and copy—perfect for competitor analysis. * 🛡️ Reliable & Consistent Built to avoid errors and deliver stable results. Perfect for marketers checking how many keywords per ad group Google Ads or comparing campaign structures. * 📥 Easy Export Download results in JSON, CSV, or your preferred format—similar to google ads transparency data exporter tools. ##🔗 What are other Google scraping tools? If you want to scrape specific Google data, you can use any of the dedicated scrapers below for faster and more targeted results. Just enter keywords, search queries, place names, app links, or URLs and start scraping instantly. | [🖼️ Google Images Scraper](https://apify.com/scraper-engine/google-images-scraper) | [⌨️ Google Search Autocomplete API](https://apify.com/scraper-engine/google-search-autocomplete-api) | |---|---| | [📰 Google News Scraper](https://apify.com/scraper-engine/google-news-scraper) | [✈️ Google Flights Scraper](https://apify.com/scraper-engine/google-flights-scraper) | | [🏨 Google Hotels Scraper](https://apify.com/scraper-engine/google-hotels-scraper) | [📈 Google Trends Scraper](https://apify.com/scraper-engine/google-trends-scraper) | | [📱 Google Play Data Extractor](https://apify.com/scraper-engine/google-play-scraper) | [⭐ Google Play Store Reviews Scraper](https://apify.com/scraper-engine/google-play-store-reviews-scraper) | | [🗺️ Google Maps Reviews Scraper](https://apify.com/scraper-engine/google-maps-reviews-scraper) | [📧 Google Play Email Scraper](https://apify.com/scraper-engine/google-play-email-scraper) | | [📍 Google Maps Extractor](https://apify.com/scraper-engine/google-maps-extractor) | [🧭 Google Maps Scraper](https://apify.com/scraper-engine/google-maps-scraper) | | [📧 Google Maps Email Scraper](https://apify.com/scraper-engine/google-maps-email-scraper) | [📱 Google Play Store App Search Scraper](https://apify.com/scraper-engine/google-play-store-app-search-scraper) | | [📨 Google Maps Email Extractor](https://apify.com/scraper-engine/google-maps-email-extractor) | [📞 Google Maps Phone Number Extractor](https://apify.com/scraper-engine/google-maps-phone-number-extractor) | | [☎️ Google Play Phone Number Scraper](https://apify.com/scraper-engine/google-play-phone-number-scraper) | [📞 Google Maps Phone Number Scraper](https://apify.com/scraper-engine/google-maps-phone-number-scraper) | ### 🧭 How to Use Google Ads Scraper Follow this simple step-by-step guide to run your Google Ads Scraper efficiently 👇: #### 🟦 Step-by-Step Guide 1. Log in to Apify Create a free account or sign in to get started. 2. Select the Actor Search for “Google Ads Scraper” or similar tools like google ads scraper apify in the Apify Store. 3. Enter Input Data Paste any advertiser URL, ad page URL, or entity ID into the startUrls field. You can use multiple URLs for bulk scraping. 4. Choose Options Select settings such as: * Extract transparency data * Include ad creatives * Include Google Ad Library records * Decide between minimal output or rich metadata 6. Run the Actor Click Start and the scraper automatically processes the Google Ads pages. 7. Download Results Export results in JSON or CSV and integrate with your workflows. This workflow works perfectly whether you're using the online interface, an API integration, or referencing repositories like silva95gustavo/google-ads-scraper, google ads scraper download, or google ads scraper github. * * * ### 🎯 Use Cases The Google Ads Scraper is incredibly valuable across many industries. Here’s how people use it daily: * 🏢 Competitor Research Analyze what competitors are running on Google Ads. Understand copy, creative style, keywords, and spend behavior. * 📊 Marketing & SEO Strategy Optimize campaigns by studying industry ad trends, relevance scores, and creative patterns. Helps answer questions like “is Google Ads profitable?” * 📚 Academic & Policy Research Extract transparency data for journalistic reports or political communication analysis using tools similar to a google ads transparency center scraper. * 🤖 Automation & Data Pipelines Integrate with APIs to feed real-time ad intelligence into dashboards and BI tools. * 📈 Agency Reporting Build competitive reports, visualize market share, or compare ad libraries across industries. * 🕵️ Brand Monitoring See if unauthorized ads or misleading impersonations are running against your brand keywords. * * * ### 💎 Why Choose Us? Choosing our Google Ads Scraper means you get unmatched precision, reliability, and performance. Here's why users trust us: * 🔥 Industry-Leading Accuracy Our scraper captures comprehensive ad details from multiple Google Ads environments, including transparency data. * ⚙️ Engineered for Scale The system handles large datasets, making it ideal for enterprise teams that require consistent, high-volume scraping. * 🧠 Insight-Driven Output Data is structured and clean, helping marketing teams create actionable insights—not clutter. * 🌐 Versatile & Flexible Supports URLs from Google Ads Transparency Center, advertiser pages, ad libraries, and more. * 🔌 Easy Integrations Works perfectly with APIs, automation workflows, and data pipelines. * 💼 Trusted by Marketers, Researchers & Agencies Perfect for those comparing google\*ads charge, charge for google ads, or analyzing historical ad performance. * * * ### 📈 How Many Results Can You Scrape With “Google Ads Scraper”? Scalability is one of the core strengths of our Google Ads Scraper 💪. Unlike small browser extensions or scripts like facebook ads scraper extension or basic scrape google ads python snippets, this scraper is built for high-volume, enterprise-grade extraction. You can scrape: * Hundreds of ads from a single advertiser * Thousands of ads across a country or category * Tens of thousands of ads across political, commercial, and brand verticals * Entire Google Ads Transparency Center datasets * Full advertiser libraries from the Google Ad Library Because the scraper supports parallelization and efficient queueing, performance is stable even when processing large lists of URLs. #### ⚡ How It Handles Large Jobs * Distributed architecture for scaling * Automatic retries to maintain clean results * Smart limits prevent errors while supporting big workloads Whether you're scraping one brand or running a global research project, the Google Ads Scraper delivers the volume and reliability required. * * * ### ⚖️ Is It Legal to Scrape “Google Ads”? Scraping Google Ads or using a Google Ads Transparency Center Scraper exists in a gray area, depending on jurisdiction and purpose. Here’s the general rule 👍: * ✔ Allowed: * Public data scraping for research, analysis, compliance, journalism * Gathering transparency information already publicly accessible * Non-intrusive scraping respecting platform rules * ❌ Not Allowed: * Bypassing authentication * Scraping private, personal, or restricted data * Misusing scraped data for deceptive practices Always follow: * Google Terms of Service * Data protection regulations (GDPR, CCPA) * Ethical research guidelines Using the tool responsibly—especially for transparency research, competitive insights, or market analysis—is typically permitted. * * * ### 🛠️ Input Parameters #### JSON Example ```json { "query": "home decor ideas", "maxResults": 10, "use_prefix": true, "use_suffix": true } ```` ### 📤 Output Format #### JSON Example ```json [ { "query": "home decor ideas", "suggestions": [ "best home decor ideas", "home decor ideas 2023", "home decor ideas on a budget", "home decor ideas for small spaces", "home decor ideas diy" ] }, .... ] ``` ### ❓ FAQ #### 1. Is the Google Ads Scraper safe to use? Yes, when used ethically and within legal guidelines. #### 2. Can I scrape Google Ads without coding? Absolutely—tools like Google Ads Scraper Apify let you scrape with zero coding. #### 3. Can I use it as a Google Ads Transparency Center Scraper? Yes! It extracts full transparency data. #### 4. Does it work like google ads scraper github scripts? Yes, but it's more powerful, stable, and scalable. #### 5. Can I export results? Yes—CSV, JSON, Excel, or API endpoints. #### 6. Is it better than scraping Google Ads with Python? For scale and speed—YES. #### 7. Does it support bulk URLs? Fully supported. #### 8. Can I analyze ad creatives? Yes—images, text, metadata, and more. ### 🏁 Conclusion The Google Ads Scraper is a powerful tool for collecting ad intelligence, transparency data, and competitive insights at scale. 🚀 Whether you're a marketer, researcher, or analyst, it delivers fast, accurate, and structured data—helping you make smarter decisions and stay ahead in the digital advertising landscape. # Actor input Schema ## `startUrls` (type: `array`): List one or more Google Ads transparency URLs (e.g., https://adstransparency.google.com/advertiser/AR04619580580634296321), advertiser IDs (e.g., AR04619580580634296321), or keywords for searching advertisers. ## `maxItems` (type: `integer`): Maximum number of ad creatives to scrape per advertiser (1-1000) ## `proxyConfiguration` (type: `object`): Configure proxy settings for reliable scraping. If blocked, the actor will automatically fallback to datacenter then residential proxies. ## Actor input object example ```json { "startUrls": [ "https://adstransparency.google.com/advertiser/AR04619580580634296321", "AR04619580580634296321", "advertising", "marketing" ], "maxItems": 100, "proxyConfiguration": { "useApifyProxy": false } } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ "https://adstransparency.google.com/advertiser/AR04619580580634296321" ], "proxyConfiguration": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("scraper-engine/google-ads-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": ["https://adstransparency.google.com/advertiser/AR04619580580634296321"], "proxyConfiguration": { "useApifyProxy": False }, } # Run the Actor and wait for it to finish run = client.actor("scraper-engine/google-ads-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ "https://adstransparency.google.com/advertiser/AR04619580580634296321" ], "proxyConfiguration": { "useApifyProxy": false } }' | apify call scraper-engine/google-ads-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scraper-engine/google-ads-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Ads Scraper", "description": "Scrape Google Ads results from any keyword. This actor extracts ad titles, descriptions, URLs, sitelinks, and ranking positions. Perfect for competitor research, PPC analysis, SERP monitoring, and campaign optimization.", "version": "0.1", "x-build-id": "kxOC60Nl6R71WUKJ3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scraper-engine~google-ads-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scraper-engine-google-ads-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/scraper-engine~google-ads-scraper/runs": { "post": { "operationId": "runs-sync-scraper-engine-google-ads-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/scraper-engine~google-ads-scraper/run-sync": { "post": { "operationId": "run-sync-scraper-engine-google-ads-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "Google Ads URLs/IDs/Keywords", "type": "array", "description": "List one or more Google Ads transparency URLs (e.g., https://adstransparency.google.com/advertiser/AR04619580580634296321), advertiser IDs (e.g., AR04619580580634296321), or keywords for searching advertisers.", "items": { "type": "string" } }, "maxItems": { "title": "Maximum Items to Scrape", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of ad creatives to scrape per advertiser (1-1000)", "default": 100 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Configure proxy settings for reliable scraping. If blocked, the actor will automatically fallback to datacenter then residential proxies." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```