Google Search Scraper
Try for free
3 days trial then $20.00/month - No credit card required now
Go to Store
Google Search Scraper
epctex/google-search-scraper
Try for free
3 days trial then $20.00/month - No credit card required now
Boost SEO with our tool! Explore organic & paid results, People Also Ask, and Related Queries. Select countries, languages, and precise locations for tailored insights.
You can access the Google Search Scraper programmatically from your own applications by using the Apify API. You can 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": "d2gk9KSNebiEqGvXD"
6 },
7 "servers": [
8 {
9 "url": "https://api.apify.com/v2"
10 }
11 ],
12 "paths": {
13 "/acts/epctex~google-search-scraper/run-sync-get-dataset-items": {
14 "post": {
15 "operationId": "run-sync-get-dataset-items-epctex-google-search-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/epctex~google-search-scraper/runs": {
50 "post": {
51 "operationId": "runs-sync-epctex-google-search-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/epctex~google-search-scraper/run-sync": {
93 "post": {
94 "operationId": "run-sync-epctex-google-search-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 "required": [
134 "proxy"
135 ],
136 "properties": {
137 "startUrls": {
138 "title": "Start URLs",
139 "type": "array",
140 "description": "URLs to start with. It should be a search URL",
141 "items": {
142 "type": "string"
143 }
144 },
145 "queries": {
146 "title": "Search Queries",
147 "type": "array",
148 "description": "(Required if you don't use 'Start URLs') You can provide a list of queries that you want to search.",
149 "items": {
150 "type": "string"
151 }
152 },
153 "csvFriendlyOutput": {
154 "title": "CSV Friendly Output",
155 "type": "boolean",
156 "description": "If enabled, each search result will be outputted to a separate file instead of in batches.",
157 "default": false
158 },
159 "countryCode": {
160 "title": "Country",
161 "enum": [
162 "us",
163 "af",
164 "al",
165 "dz",
166 "as",
167 "ad",
168 "ao",
169 "ai",
170 "aq",
171 "ag",
172 "ar",
173 "am",
174 "aw",
175 "au",
176 "at",
177 "az",
178 "bs",
179 "bh",
180 "bd",
181 "bb",
182 "by",
183 "be",
184 "bz",
185 "bj",
186 "bm",
187 "bt",
188 "bo",
189 "ba",
190 "bw",
191 "bv",
192 "br",
193 "io",
194 "bn",
195 "bg",
196 "bf",
197 "bi",
198 "kh",
199 "cm",
200 "ca",
201 "cv",
202 "ky",
203 "cf",
204 "td",
205 "cl",
206 "cn",
207 "cx",
208 "cc",
209 "co",
210 "km",
211 "cg",
212 "cd",
213 "ck",
214 "cr",
215 "ci",
216 "hr",
217 "cu",
218 "cy",
219 "cz",
220 "dk",
221 "dj",
222 "dm",
223 "do",
224 "ec",
225 "eg",
226 "sv",
227 "gq",
228 "er",
229 "ee",
230 "et",
231 "fk",
232 "fo",
233 "fj",
234 "fi",
235 "fr",
236 "gf",
237 "pf",
238 "tf",
239 "ga",
240 "gm",
241 "ge",
242 "de",
243 "gh",
244 "gi",
245 "gr",
246 "gl",
247 "gd",
248 "gp",
249 "gu",
250 "gt",
251 "gn",
252 "gw",
253 "gy",
254 "ht",
255 "hm",
256 "va",
257 "hn",
258 "hk",
259 "hu",
260 "is",
261 "in",
262 "id",
263 "ir",
264 "iq",
265 "ie",
266 "il",
267 "it",
268 "jm",
269 "jp",
270 "jo",
271 "kz",
272 "ke",
273 "ki",
274 "kp",
275 "kr",
276 "kw",
277 "kg",
278 "la",
279 "lv",
280 "lb",
281 "ls",
282 "lr",
283 "ly",
284 "li",
285 "lt",
286 "lu",
287 "mo",
288 "mk",
289 "mg",
290 "mw",
291 "my",
292 "mv",
293 "ml",
294 "mt",
295 "mh",
296 "mq",
297 "mr",
298 "mu",
299 "yt",
300 "mx",
301 "fm",
302 "md",
303 "mc",
304 "mn",
305 "ms",
306 "ma",
307 "mz",
308 "mm",
309 "na",
310 "nr",
311 "np",
312 "nl",
313 "an",
314 "nc",
315 "nz",
316 "ni",
317 "ne",
318 "ng",
319 "nu",
320 "nf",
321 "mp",
322 "no",
323 "om",
324 "pk",
325 "pw",
326 "ps",
327 "pa",
328 "pg",
329 "py",
330 "pe",
331 "ph",
332 "pn",
333 "pl",
334 "pt",
335 "pr",
336 "qa",
337 "re",
338 "ro",
339 "ru",
340 "rw",
341 "sh",
342 "kn",
343 "lc",
344 "pm",
345 "vc",
346 "ws",
347 "sm",
348 "st",
349 "sa",
350 "sn",
351 "cs",
352 "sc",
353 "sl",
354 "sg",
355 "sk",
356 "si",
357 "sb",
358 "so",
359 "za",
360 "gs",
361 "es",
362 "lk",
363 "sd",
364 "sr",
365 "sj",
366 "sz",
367 "se",
368 "ch",
369 "sy",
370 "tw",
371 "tj",
372 "tz",
373 "th",
374 "tl",
375 "tg",
376 "tk",
377 "to",
378 "tt",
379 "tn",
380 "tr",
381 "tm",
382 "tc",
383 "tv",
384 "ug",
385 "ua",
386 "ae",
387 "gb",
388 "um",
389 "uy",
390 "uz",
391 "vu",
392 "ve",
393 "vn",
394 "vg",
395 "vi",
396 "wf",
397 "eh",
398 "ye",
399 "zm",
400 "zw"
401 ],
402 "type": "string",
403 "description": "Country determines the Google Search domain (e.g. <code>google.es</code> for Spain). <br><br>This setting only applies to Search queries.",
404 "default": "us"
405 },
406 "languageCode": {
407 "title": "Language",
408 "enum": [
409 "en",
410 "af",
411 "ak",
412 "sq",
413 "ws",
414 "am",
415 "ar",
416 "hy",
417 "az",
418 "eu",
419 "be",
420 "bem",
421 "bn",
422 "bh",
423 "xx-bork",
424 "bs",
425 "br",
426 "bg",
427 "bt",
428 "km",
429 "ca",
430 "chr",
431 "ny",
432 "zh-cn",
433 "zh-tw",
434 "co",
435 "hr",
436 "cs",
437 "da",
438 "nl",
439 "xx-elmer",
440 "eo",
441 "et",
442 "ee",
443 "fo",
444 "tl",
445 "fi",
446 "fr",
447 "fy",
448 "gaa",
449 "gl",
450 "ka",
451 "de",
452 "el",
453 "kl",
454 "gn",
455 "gu",
456 "xx-hacker",
457 "ht",
458 "ha",
459 "haw",
460 "iw",
461 "hi",
462 "hu",
463 "is",
464 "ig",
465 "id",
466 "ia",
467 "ga",
468 "it",
469 "ja",
470 "jw",
471 "kn",
472 "kk",
473 "rw",
474 "rn",
475 "xx-klingon",
476 "kg",
477 "ko",
478 "kri",
479 "ku",
480 "ckb",
481 "ky",
482 "lo",
483 "la",
484 "lv",
485 "ln",
486 "lt",
487 "loz",
488 "lg",
489 "ach",
490 "mk",
491 "mg",
492 "my",
493 "ml",
494 "mt",
495 "mv",
496 "mi",
497 "mr",
498 "mfe",
499 "mo",
500 "mn",
501 "sr-me",
502 "ne",
503 "pcm",
504 "nso",
505 "no",
506 "nn",
507 "oc",
508 "or",
509 "om",
510 "ps",
511 "fa",
512 "xx-pirate",
513 "pl",
514 "pt",
515 "pt-br",
516 "pt-pt",
517 "pa",
518 "qu",
519 "ro",
520 "rm",
521 "nyn",
522 "ru",
523 "gd",
524 "sr",
525 "sh",
526 "st",
527 "tn",
528 "crs",
529 "sn",
530 "sd",
531 "si",
532 "sk",
533 "sl",
534 "so",
535 "es",
536 "es-419",
537 "su",
538 "sw",
539 "sv",
540 "tg",
541 "ta",
542 "tt",
543 "te",
544 "th",
545 "ti",
546 "to",
547 "lua",
548 "tum",
549 "tr",
550 "tk",
551 "tw",
552 "ug",
553 "uk",
554 "ur",
555 "uz",
556 "vu",
557 "vi",
558 "cy",
559 "wo",
560 "xh",
561 "yi",
562 "yo",
563 "zu"
564 ],
565 "type": "string",
566 "description": "Language for the search results, which is passed to Google Search as the hl URL query parameter. (af, tr, de, etc...)",
567 "default": "en"
568 },
569 "locationUule": {
570 "title": "Location UULE",
571 "type": "string",
572 "description": "The code for the exact location for the Google search. It's passed to Google Search as the uule URL query parameter. You can use the UULE code generator https://padavvan.github.io/"
573 },
574 "maxItems": {
575 "title": "Maximum number of items",
576 "type": "integer",
577 "description": "Maximum number of items that you want as output. Default is all"
578 },
579 "resultsPerPage": {
580 "title": "Results per page",
581 "enum": [
582 "10",
583 "20",
584 "30",
585 "40",
586 "50",
587 "100"
588 ],
589 "type": "string",
590 "description": "Number of search results for each Google result page. By default, Google Search returns 10 results per page. The allowed values are 10, 20, 30, 40, 50 and 100.",
591 "default": "10"
592 },
593 "includeUnfilteredResults": {
594 "title": "Include unfiltered results",
595 "type": "boolean",
596 "description": "If checked, the lower-quality results that Google normally filters out will be included. This usually consists of a few hundred extra results.",
597 "default": false
598 },
599 "includePeopleAlsoAsk": {
600 "title": "Include people also ask section",
601 "type": "boolean",
602 "description": "If checked, the 'People also ask' field will be included in the output.",
603 "default": true
604 },
605 "endPage": {
606 "title": "List end page",
607 "type": "integer",
608 "description": "The page number that you want to end with. By default there is no end page. This is applies to all search request and startUrls individually."
609 },
610 "extendOutputFunction": {
611 "title": "Extend output function",
612 "type": "string",
613 "description": "Function that takes a JQuery handle ($) as argument and returns data that will be merged with the default output"
614 },
615 "customMapFunction": {
616 "title": "Custom map function",
617 "type": "string",
618 "description": "Function that takes each of the objects as argument and returns data that will be mapped by the function itself."
619 },
620 "proxy": {
621 "title": "Proxy configuration",
622 "type": "object",
623 "description": "Select proxies to be used by your crawler."
624 }
625 }
626 },
627 "runsResponseSchema": {
628 "type": "object",
629 "properties": {
630 "data": {
631 "type": "object",
632 "properties": {
633 "id": {
634 "type": "string"
635 },
636 "actId": {
637 "type": "string"
638 },
639 "userId": {
640 "type": "string"
641 },
642 "startedAt": {
643 "type": "string",
644 "format": "date-time",
645 "example": "2025-01-08T00:00:00.000Z"
646 },
647 "finishedAt": {
648 "type": "string",
649 "format": "date-time",
650 "example": "2025-01-08T00:00:00.000Z"
651 },
652 "status": {
653 "type": "string",
654 "example": "READY"
655 },
656 "meta": {
657 "type": "object",
658 "properties": {
659 "origin": {
660 "type": "string",
661 "example": "API"
662 },
663 "userAgent": {
664 "type": "string"
665 }
666 }
667 },
668 "stats": {
669 "type": "object",
670 "properties": {
671 "inputBodyLen": {
672 "type": "integer",
673 "example": 2000
674 },
675 "rebootCount": {
676 "type": "integer",
677 "example": 0
678 },
679 "restartCount": {
680 "type": "integer",
681 "example": 0
682 },
683 "resurrectCount": {
684 "type": "integer",
685 "example": 0
686 },
687 "computeUnits": {
688 "type": "integer",
689 "example": 0
690 }
691 }
692 },
693 "options": {
694 "type": "object",
695 "properties": {
696 "build": {
697 "type": "string",
698 "example": "latest"
699 },
700 "timeoutSecs": {
701 "type": "integer",
702 "example": 300
703 },
704 "memoryMbytes": {
705 "type": "integer",
706 "example": 1024
707 },
708 "diskMbytes": {
709 "type": "integer",
710 "example": 2048
711 }
712 }
713 },
714 "buildId": {
715 "type": "string"
716 },
717 "defaultKeyValueStoreId": {
718 "type": "string"
719 },
720 "defaultDatasetId": {
721 "type": "string"
722 },
723 "defaultRequestQueueId": {
724 "type": "string"
725 },
726 "buildNumber": {
727 "type": "string",
728 "example": "1.0.0"
729 },
730 "containerUrl": {
731 "type": "string"
732 },
733 "usage": {
734 "type": "object",
735 "properties": {
736 "ACTOR_COMPUTE_UNITS": {
737 "type": "integer",
738 "example": 0
739 },
740 "DATASET_READS": {
741 "type": "integer",
742 "example": 0
743 },
744 "DATASET_WRITES": {
745 "type": "integer",
746 "example": 0
747 },
748 "KEY_VALUE_STORE_READS": {
749 "type": "integer",
750 "example": 0
751 },
752 "KEY_VALUE_STORE_WRITES": {
753 "type": "integer",
754 "example": 1
755 },
756 "KEY_VALUE_STORE_LISTS": {
757 "type": "integer",
758 "example": 0
759 },
760 "REQUEST_QUEUE_READS": {
761 "type": "integer",
762 "example": 0
763 },
764 "REQUEST_QUEUE_WRITES": {
765 "type": "integer",
766 "example": 0
767 },
768 "DATA_TRANSFER_INTERNAL_GBYTES": {
769 "type": "integer",
770 "example": 0
771 },
772 "DATA_TRANSFER_EXTERNAL_GBYTES": {
773 "type": "integer",
774 "example": 0
775 },
776 "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
777 "type": "integer",
778 "example": 0
779 },
780 "PROXY_SERPS": {
781 "type": "integer",
782 "example": 0
783 }
784 }
785 },
786 "usageTotalUsd": {
787 "type": "number",
788 "example": 0.00005
789 },
790 "usageUsd": {
791 "type": "object",
792 "properties": {
793 "ACTOR_COMPUTE_UNITS": {
794 "type": "integer",
795 "example": 0
796 },
797 "DATASET_READS": {
798 "type": "integer",
799 "example": 0
800 },
801 "DATASET_WRITES": {
802 "type": "integer",
803 "example": 0
804 },
805 "KEY_VALUE_STORE_READS": {
806 "type": "integer",
807 "example": 0
808 },
809 "KEY_VALUE_STORE_WRITES": {
810 "type": "number",
811 "example": 0.00005
812 },
813 "KEY_VALUE_STORE_LISTS": {
814 "type": "integer",
815 "example": 0
816 },
817 "REQUEST_QUEUE_READS": {
818 "type": "integer",
819 "example": 0
820 },
821 "REQUEST_QUEUE_WRITES": {
822 "type": "integer",
823 "example": 0
824 },
825 "DATA_TRANSFER_INTERNAL_GBYTES": {
826 "type": "integer",
827 "example": 0
828 },
829 "DATA_TRANSFER_EXTERNAL_GBYTES": {
830 "type": "integer",
831 "example": 0
832 },
833 "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
834 "type": "integer",
835 "example": 0
836 },
837 "PROXY_SERPS": {
838 "type": "integer",
839 "example": 0
840 }
841 }
842 }
843 }
844 }
845 }
846 }
847 }
848 }
849}Google Search Scraper 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 Search Scraper 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:
Developer
epctexMaintained by Community
Actor Metrics
111 monthly users
-
11 bookmarks
95% runs succeeded
9.3 hours response time
Created in Sep 2023
Modified a day ago
Categories
