Google Ads Scraper

🔎 What is Google Ads Scraper?

It's a simple and powerful tool that allows you to extract data from Google Ads by reading data from its official public Ad Library named Google Ads Transparency Center.

To get that data, just insert the intended URL from Google Ads Transparency Center and click "Save & Start" button.

📊 What Google ads data can I extract?

All ad formats are supported by this Google Ads API, meaning that it can extract text, image or video ads. With this API, you will be able to extract the following data:

• Ad format
• Preview image URL
• Geo regions where the ad is displayed
• Ad variations
• Headline
• Description
• Call-to-action button
• Image URL for image ads
• Video URL for video ads
• Number of impressions (with breakdown by region and platform)

📖 How to use

⬇️ Input

The input for the Google Ads Scraper should be a Google Ads Transparency Center URL after a specific advertiser is selected. It is important to ensure that the input URL starts with https://adstransparency.google.com/advertiser/AR<advertiser_id>/.... Example:

1{
2    "startUrls": [
3        {
4            "url": "https://adstransparency.google.com/advertiser/AR17819574463608389633?authuser=0&region=US&preset-date=Last+7+days"
5        }
6    ]
7}

You can obtain an input start URL in one of two ways:

Option 1 - searching for an advertiser or domain directly:

1. Using the search feature of Google Ads Transparency Center, write the name of your advertiser.
2. From the search dropdown, choose a result that corresponds to a single advertiser or a domain name. Do not select any entry mentioning that "multiple advertiser accounts have a similar name".
3. Copy the current browser URL and use it as input in this scraper.

Option 2 - selecting an advertiser from the list of ads:

1. Search for ads from the advertiser you are interested in.
2. In the list view, click the intended advertiser name, which should be displayed at the bottom of the card corresponding to each ad.
3. Copy the current browser URL and use it as input in this scraper.

⬆️ Output

The results will be wrapped into a dataset which you can find in the Storage tab. You can choose in which format to download your Facebook data: JSON, JSONL, Excel spreadsheet, HTML table, CSV, or XML. Each item will contain an ad as in the following example:

1{
2    "advertiserId": "AR09717407487665111041",
3    "advertiserName": "Facebook Technologies, LLC",
4    "creativeId": "CR12606781830503333889",
5    "format": "IMAGE",
6    "previewUrl": "https://tpc.googlesyndication.com/archive/simgad/17685446209999002958",
7    "regionStats": [
8        {
9            "regionCode": "DE",
10            "regionName": "Germany",
11            "firstShown": "2023-07-04",
12            "lastShown": "2024-05-17",
13            "impressions": {
14                "lowerBound": 1000,
15                "upperBound": 2000
16            },
17            "surfaceServingStats": [
18                {
19                    "surfaceCode": "YOUTUBE",
20                    "surfaceName": "YouTube",
21                    "impressions": {
22                        "lowerBound": 1000,
23                        "upperBound": 2000
24                    }
25                },
26                {
27                    "surfaceCode": "SEARCH",
28                    "surfaceName": "Google Search",
29                    "impressions": {
30                        "lowerBound": 0,
31                        "upperBound": 1000
32                    }
33                }
34            ]
35        }
36    ],
37    "startUrl": "https://adstransparency.google.com/?authuser=0&region=DE&domain=facebook.com",
38    "variations": [
39        {
40            "description": "Get the guide to\ndiscover how VR can\nhelp to bring your\nwildest ideas to life.",
41            "headline": "Download Your\nFree Guide",
42            "imageUrl": "https:/tpc.googlesyndication.com/archive/sadbundle/$csp%3Darchive$/7713083310730891859/2j0c2fr49kkzz.jpeg"
43        },
44        {
45            "description": "Get the guide to\ndiscover how VR can\nhelp to bring your\nwildest ideas to life.",
46            "headline": "5 Fresh Creative\nInsights",
47            "imageUrl": "https:/tpc.googlesyndication.com/archive/sadbundle/$csp%3Darchive$/3729438442968006029/2j0c2fr49kkzz.jpeg"
48        },
49        {
50            "description": "Solve your top 5 creative\nchallenges with VR",
51            "headline": "Download Your\nFree Guide",
52            "imageUrl": "https:/tpc.googlesyndication.com/archive/sadbundle/$csp%3Darchive$/10516008805262833060/24mluwkpkorv3.jpeg"
53        }
54    ]
55}

♾️ How many ads can you scrape with Google Ads Scraper?

As many as you can imagine! This scraper has an unlimited appetite for ads, and it will automatically scroll down the list of results until it reaches the end. Happy scraping and may your data flow freely! 🚀😄

💬 Your feedback

Let us know if you have any feedback or feature requests through the issues tab. Your input helps drive future improvements.