Google Ads Scraper Pro beta
Pricing
Pay per usage
Go to Store
Google Ads Scraper Pro beta
Google Ads Scraper beta
5.0 (3)
Pricing
Pay per usage
3
Total users
1
Monthly users
1
Runs succeeded
>99%
Last modified
3 days ago
You can access the Google Ads Scraper Pro beta programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.
1{
2 "openapi": "3.0.1",
3 "info": {
4 "version": "0.0",
5 "x-build-id": "oMIQ28OVuZUdrf25H"
6 },
7 "servers": [
8 {
9 "url": "https://api.apify.com/v2"
10 }
11 ],
12 "paths": {
13 "/acts/dz_omar~google-ads-scraper/run-sync-get-dataset-items": {
14 "post": {
15 "operationId": "run-sync-get-dataset-items-dz_omar-google-ads-scraper",
16 "x-openai-isConsequential": false,
17 "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
18 "tags": [
19 "Run Actor"
20 ],
21 "requestBody": {
22 "required": true,
23 "content": {
24 "application/json": {
25 "schema": {
26 "$ref": "#/components/schemas/inputSchema"
27 }
28 }
29 }
30 },
31 "parameters": [
32 {
33 "name": "token",
34 "in": "query",
35 "required": true,
36 "schema": {
37 "type": "string"
38 },
39 "description": "Enter your Apify token here"
40 }
41 ],
42 "responses": {
43 "200": {
44 "description": "OK"
45 }
46 }
47 }
48 },
49 "/acts/dz_omar~google-ads-scraper/runs": {
50 "post": {
51 "operationId": "runs-sync-dz_omar-google-ads-scraper",
52 "x-openai-isConsequential": false,
53 "summary": "Executes an Actor and returns information about the initiated run in response.",
54 "tags": [
55 "Run Actor"
56 ],
57 "requestBody": {
58 "required": true,
59 "content": {
60 "application/json": {
61 "schema": {
62 "$ref": "#/components/schemas/inputSchema"
63 }
64 }
65 }
66 },
67 "parameters": [
68 {
69 "name": "token",
70 "in": "query",
71 "required": true,
72 "schema": {
73 "type": "string"
74 },
75 "description": "Enter your Apify token here"
76 }
77 ],
78 "responses": {
79 "200": {
80 "description": "OK",
81 "content": {
82 "application/json": {
83 "schema": {
84 "$ref": "#/components/schemas/runsResponseSchema"
85 }
86 }
87 }
88 }
89 }
90 }
91 },
92 "/acts/dz_omar~google-ads-scraper/run-sync": {
93 "post": {
94 "operationId": "run-sync-dz_omar-google-ads-scraper",
95 "x-openai-isConsequential": false,
96 "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
97 "tags": [
98 "Run Actor"
99 ],
100 "requestBody": {
101 "required": true,
102 "content": {
103 "application/json": {
104 "schema": {
105 "$ref": "#/components/schemas/inputSchema"
106 }
107 }
108 }
109 },
110 "parameters": [
111 {
112 "name": "token",
113 "in": "query",
114 "required": true,
115 "schema": {
116 "type": "string"
117 },
118 "description": "Enter your Apify token here"
119 }
120 ],
121 "responses": {
122 "200": {
123 "description": "OK"
124 }
125 }
126 }
127 }
128 },
129 "components": {
130 "schemas": {
131 "inputSchema": {
132 "type": "object",
133 "properties": {
134 "Use_URL_Filter": {
135 "title": "Use parameter URL as a filter",
136 "type": "boolean",
137 "description": "Debug messages will be included in the log.",
138 "default": true
139 },
140 "isPolitical": {
141 "title": "isPolitical",
142 "type": "boolean",
143 "description": "Debug messages will be included in the log.",
144 "default": true
145 },
146 "keyword_domain_advertiserid": {
147 "title": "Search Keywords",
148 "type": "array",
149 "description": "Enter one or more keywords to search for relevant ads.",
150 "default": [
151 "AR05789404224659914753",
152 "https://adstransparency.google.com/advertiser/AR05789404224659914753?region=US&topic=political&preset-date=Last+7+days&format=VIDEO&platform=YOUTUBE"
153 ],
154 "items": {
155 "type": "string"
156 }
157 },
158 "limitResults": {
159 "title": "limit Results",
160 "type": "integer",
161 "description": "Specify the maximum number of unique domains to retrieve.",
162 "default": 3
163 },
164 "maxDomains": {
165 "title": "Maximum Domains",
166 "type": "integer",
167 "description": "Specify the maximum number of unique domains to retrieve.",
168 "default": 0
169 },
170 "maxAdvertisers": {
171 "title": "Maximum Advertisers",
172 "type": "integer",
173 "description": "Set the maximum number of advertisers to fetch results from.",
174 "default": 10
175 },
176 "platform": {
177 "title": "",
178 "enum": [
179 "0",
180 "2",
181 "1",
182 "4",
183 "3",
184 "5"
185 ],
186 "type": "string",
187 "description": "",
188 "default": "0"
189 },
190 "format": {
191 "title": "Ad Format",
192 "enum": [
193 "0",
194 "1",
195 "2",
196 "3"
197 ],
198 "type": "string",
199 "description": "Select the preferred ad format to filter results.",
200 "default": "0"
201 },
202 "presetDate": {
203 "title": "Date Range",
204 "enum": [
205 "0",
206 "1",
207 "7",
208 "30",
209 "-1"
210 ],
211 "type": "string",
212 "description": "Select a predefined date range for filtering ads.",
213 "default": "0"
214 },
215 "startDate": {
216 "title": "Start Date",
217 "type": "string",
218 "description": "Specify a custom start date for filtering ads (YYYYMMDD).",
219 "default": "2024-01-01"
220 },
221 "endDate": {
222 "title": "End Date",
223 "type": "string",
224 "description": "Specify a custom end date for filtering ads (YYYYMMDD)."
225 },
226 "region": {
227 "title": "Target Region",
228 "enum": [
229 "Albania",
230 "Algeria",
231 "American Samoa",
232 "Andorra",
233 "Angola",
234 "Antarctica",
235 "Antigua and Barbuda",
236 "Argentina",
237 "Armenia",
238 "Australia",
239 "Austria",
240 "Azerbaijan",
241 "Bahrain",
242 "Bangladesh",
243 "Barbados",
244 "Belarus",
245 "Belgium",
246 "Belize",
247 "Benin",
248 "Bhutan",
249 "Bolivia",
250 "Bosnia and Herzegovina",
251 "Botswana",
252 "Brazil",
253 "Brunei",
254 "Bulgaria",
255 "Burkina Faso",
256 "Burundi",
257 "Cambodia",
258 "Cameroon",
259 "Canada",
260 "Cabo Verde",
261 "Caribbean Netherlands",
262 "Central African Republic",
263 "Chad",
264 "Chile",
265 "China",
266 "Christmas Island",
267 "Cocos (Keeling) Islands",
268 "Colombia",
269 "Comoros",
270 "Cook Islands",
271 "Costa Rica",
272 "Cote d'Ivoire",
273 "Croatia",
274 "Curacao",
275 "Cyprus",
276 "Czechia",
277 "Democratic Republic of the Congo",
278 "Denmark",
279 "Djibouti",
280 "Dominica",
281 "Dominican Republic",
282 "Ecuador",
283 "Egypt",
284 "El Salvador",
285 "Equatorial Guinea",
286 "Eritrea",
287 "Estonia",
288 "Eswatini",
289 "Ethiopia",
290 "Micronesia",
291 "Fiji",
292 "Finland",
293 "France",
294 "French Polynesia",
295 "French Southern and Antarctic Lands",
296 "Gabon",
297 "Georgia",
298 "Germany",
299 "Ghana",
300 "Greece",
301 "Grenada",
302 "Guam",
303 "Guatemala",
304 "Guernsey",
305 "Guinea",
306 "Guinea-Bissau",
307 "Guyana",
308 "Haiti",
309 "Heard Island and McDonald Islands",
310 "Honduras",
311 "Hungary",
312 "Iceland",
313 "India",
314 "Indonesia",
315 "Iraq",
316 "Ireland",
317 "Israel",
318 "Italy",
319 "Jamaica",
320 "Japan",
321 "Jersey",
322 "Jordan",
323 "Kazakhstan",
324 "Kenya",
325 "Kiribati",
326 "Kuwait",
327 "Kyrgyzstan",
328 "Laos",
329 "Latvia",
330 "Lebanon",
331 "Lesotho",
332 "Liberia",
333 "Libya",
334 "Liechtenstein",
335 "Lithuania",
336 "Luxembourg",
337 "Madagascar",
338 "Malawi",
339 "Malaysia",
340 "Maldives",
341 "Malta",
342 "Mali",
343 "Marshall Islands",
344 "Mauritania",
345 "Mauritius",
346 "Mexico",
347 "Moldova",
348 "Monaco",
349 "Mongolia",
350 "Montenegro",
351 "Morocco",
352 "Mozambique",
353 "Myanmar (Burma)",
354 "Namibia",
355 "Nauru",
356 "Nepal",
357 "Netherlands",
358 "New Caledonia",
359 "New Zealand",
360 "Nicaragua",
361 "Niger",
362 "Nigeria",
363 "Niue",
364 "Norfolk Island",
365 "North Macedonia",
366 "Northern Mariana Islands",
367 "Norway",
368 "Oman",
369 "Pakistan",
370 "Palau",
371 "Panama",
372 "Papua New Guinea",
373 "Paraguay",
374 "Peru",
375 "Philippines",
376 "Pitcairn Islands",
377 "Poland",
378 "Portugal",
379 "Qatar",
380 "Republic of the Congo",
381 "Romania",
382 "Rwanda",
383 "Saint Helena, Ascension and Tristan da Cunha",
384 "Saint Kitts and Nevis",
385 "Saint Lucia",
386 "Saint Pierre and Miquelon",
387 "Saint Vincent and the Grenadines",
388 "Samoa",
389 "San Marino",
390 "Sao Tome and Principe",
391 "Saudi Arabia",
392 "Senegal",
393 "Seychelles",
394 "Sierra Leone",
395 "Singapore",
396 "Sint Maarten",
397 "Slovakia",
398 "Slovenia",
399 "Solomon Islands",
400 "Somalia",
401 "South Africa",
402 "South Georgia and the South Sandwich Islands",
403 "South Korea",
404 "Spain",
405 "Sri Lanka",
406 "Suriname",
407 "Switzerland",
408 "Sweden",
409 "Tajikistan",
410 "Tanzania",
411 "Thailand",
412 "The Bahamas",
413 "The Gambia",
414 "Timor-Leste",
415 "Togo",
416 "Tokelau",
417 "Tonga",
418 "Trinidad and Tobago",
419 "Tunisia",
420 "Turkiye",
421 "Turkmenistan",
422 "Tuvalu",
423 "Uganda",
424 "Ukraine",
425 "United Arab Emirates",
426 "United Kingdom",
427 "United States",
428 "Uruguay",
429 "Uzbekistan",
430 "Vanuatu",
431 "Vatican City",
432 "Venezuela",
433 "Vietnam",
434 "Yemen",
435 "Zambia",
436 "Zimbabwe",
437 "Bermuda",
438 "Bouvet Island",
439 "British Indian Ocean Territory",
440 "British Virgin Islands",
441 "Canary Islands",
442 "Cayman Islands",
443 "Taiwan",
444 "Mayotte",
445 "Faroe Islands",
446 "Falkland Islands (Islas Malvinas)",
447 "French Guiana",
448 "Palestine",
449 "Gibraltar",
450 "Greenland",
451 "Guadeloupe",
452 "Hong Kong",
453 "Isle of Man",
454 "Macao",
455 "Martinique",
456 "Montserrat",
457 "Aruba",
458 "Puerto Rico",
459 "Reunion",
460 "Anguilla",
461 "Western Sahara",
462 "Saint Martin",
463 "Svalbard and Jan Mayen",
464 "Turks and Caicos Islands",
465 "United States Minor Outlying Islands",
466 "U.S. Virgin Islands",
467 "Wallis and Futuna"
468 ],
469 "type": "string",
470 "description": "Select a specific country/region to filter ads."
471 },
472 "proxyConfig": {
473 "title": "Proxy",
474 "type": "object",
475 "description": "Configure proxy settings to use during the scan. Utilizing proxies can help you avoid IP bans, bypass WAF (Web Application Firewall) restrictions, and access specific geographical regions. This ensures smooth crawling across various environments and enhances the overall efficiency and reliability of your scanning activities.",
476 "default": {
477 "useApifyProxy": false
478 }
479 }
480 }
481 },
482 "runsResponseSchema": {
483 "type": "object",
484 "properties": {
485 "data": {
486 "type": "object",
487 "properties": {
488 "id": {
489 "type": "string"
490 },
491 "actId": {
492 "type": "string"
493 },
494 "userId": {
495 "type": "string"
496 },
497 "startedAt": {
498 "type": "string",
499 "format": "date-time",
500 "example": "2025-01-08T00:00:00.000Z"
501 },
502 "finishedAt": {
503 "type": "string",
504 "format": "date-time",
505 "example": "2025-01-08T00:00:00.000Z"
506 },
507 "status": {
508 "type": "string",
509 "example": "READY"
510 },
511 "meta": {
512 "type": "object",
513 "properties": {
514 "origin": {
515 "type": "string",
516 "example": "API"
517 },
518 "userAgent": {
519 "type": "string"
520 }
521 }
522 },
523 "stats": {
524 "type": "object",
525 "properties": {
526 "inputBodyLen": {
527 "type": "integer",
528 "example": 2000
529 },
530 "rebootCount": {
531 "type": "integer",
532 "example": 0
533 },
534 "restartCount": {
535 "type": "integer",
536 "example": 0
537 },
538 "resurrectCount": {
539 "type": "integer",
540 "example": 0
541 },
542 "computeUnits": {
543 "type": "integer",
544 "example": 0
545 }
546 }
547 },
548 "options": {
549 "type": "object",
550 "properties": {
551 "build": {
552 "type": "string",
553 "example": "latest"
554 },
555 "timeoutSecs": {
556 "type": "integer",
557 "example": 300
558 },
559 "memoryMbytes": {
560 "type": "integer",
561 "example": 1024
562 },
563 "diskMbytes": {
564 "type": "integer",
565 "example": 2048
566 }
567 }
568 },
569 "buildId": {
570 "type": "string"
571 },
572 "defaultKeyValueStoreId": {
573 "type": "string"
574 },
575 "defaultDatasetId": {
576 "type": "string"
577 },
578 "defaultRequestQueueId": {
579 "type": "string"
580 },
581 "buildNumber": {
582 "type": "string",
583 "example": "1.0.0"
584 },
585 "containerUrl": {
586 "type": "string"
587 },
588 "usage": {
589 "type": "object",
590 "properties": {
591 "ACTOR_COMPUTE_UNITS": {
592 "type": "integer",
593 "example": 0
594 },
595 "DATASET_READS": {
596 "type": "integer",
597 "example": 0
598 },
599 "DATASET_WRITES": {
600 "type": "integer",
601 "example": 0
602 },
603 "KEY_VALUE_STORE_READS": {
604 "type": "integer",
605 "example": 0
606 },
607 "KEY_VALUE_STORE_WRITES": {
608 "type": "integer",
609 "example": 1
610 },
611 "KEY_VALUE_STORE_LISTS": {
612 "type": "integer",
613 "example": 0
614 },
615 "REQUEST_QUEUE_READS": {
616 "type": "integer",
617 "example": 0
618 },
619 "REQUEST_QUEUE_WRITES": {
620 "type": "integer",
621 "example": 0
622 },
623 "DATA_TRANSFER_INTERNAL_GBYTES": {
624 "type": "integer",
625 "example": 0
626 },
627 "DATA_TRANSFER_EXTERNAL_GBYTES": {
628 "type": "integer",
629 "example": 0
630 },
631 "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
632 "type": "integer",
633 "example": 0
634 },
635 "PROXY_SERPS": {
636 "type": "integer",
637 "example": 0
638 }
639 }
640 },
641 "usageTotalUsd": {
642 "type": "number",
643 "example": 0.00005
644 },
645 "usageUsd": {
646 "type": "object",
647 "properties": {
648 "ACTOR_COMPUTE_UNITS": {
649 "type": "integer",
650 "example": 0
651 },
652 "DATASET_READS": {
653 "type": "integer",
654 "example": 0
655 },
656 "DATASET_WRITES": {
657 "type": "integer",
658 "example": 0
659 },
660 "KEY_VALUE_STORE_READS": {
661 "type": "integer",
662 "example": 0
663 },
664 "KEY_VALUE_STORE_WRITES": {
665 "type": "number",
666 "example": 0.00005
667 },
668 "KEY_VALUE_STORE_LISTS": {
669 "type": "integer",
670 "example": 0
671 },
672 "REQUEST_QUEUE_READS": {
673 "type": "integer",
674 "example": 0
675 },
676 "REQUEST_QUEUE_WRITES": {
677 "type": "integer",
678 "example": 0
679 },
680 "DATA_TRANSFER_INTERNAL_GBYTES": {
681 "type": "integer",
682 "example": 0
683 },
684 "DATA_TRANSFER_EXTERNAL_GBYTES": {
685 "type": "integer",
686 "example": 0
687 },
688 "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
689 "type": "integer",
690 "example": 0
691 },
692 "PROXY_SERPS": {
693 "type": "integer",
694 "example": 0
695 }
696 }
697 }
698 }
699 }
700 }
701 }
702 }
703 }
704}Google Ads Scraper Pro beta OpenAPI definition
OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.
OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.
By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.
You can download the OpenAPI definitions for Google Ads Scraper Pro beta from the options below:
If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.
You can also check out our other API clients:
