Information for Google Search Scraper Actor

Overview

The Google Search Scraper Actor performs automated Google searches based on user-defined queries and returns the results in a structured JSON format. It supports various filters such as site-specific searches, language preferences, country codes, and safe search options. This actor is ideal for developers and analysts who need automated and customizable Google search data extraction.

Input Parameters

• query: (string, required) The search term to be used in the Google search.
• num_pages: (integer, optional) The number of search result pages to retrieve (default is 1).
• site_filter: (string, optional) Restrict results to a specific site (e.g., example.com).
• country_code: (string, optional) The country code for localized searches (default is 'US').
• language: (string, optional) The language for the search results (default is 'en').
• search_type: (string, optional) Specify the type of search (e.g., 'news', 'images').
• date_range: (string, optional) Limit results to a specific date range (e.g., 'w' for the last week).
• safe_search: (boolean, optional) Enable safe search to filter explicit content (default is False).

Example Input

1{
2  "query": "python programming",
3  "num_pages": 2,
4  "site_filter": "python.org",
5  "country_code": "US",
6  "language": "en",
7  "search_type": "news",
8  "date_range": "w",
9  "safe_search": true
10}

Example Output

The actor returns a JSON array where each element contains search results, structured as follows:

1[
2     {
3        "term": "python site:python.org",
4        "url": "https://docs.python.org/",
5        "device": "DESKTOP",
6        "page": 1,
7        "type": "organic",
8        "domain": "google.com",
9        "countryCode": "US",
10        "resultsPerPage": "10",
11        "title": "3.12.4 Documentation",
12        "displayedUrl": "https://docs.python.org",
13        "description": "3 days ago — Python setup and usage. How to install, configure, and use Python. Python HOWTOs. In-depth topic manuals. Installing Python modules. Third-party modules and ...",
14        "emphasizedKeywords": "python site:python.org",
15        "siteLinks": [],
16        "position": 1
17    },
18    {
19        "term": "python site:python.org",
20        "url": "https://www.python.org/downloads/release/python-3130rc1/",
21        "device": "DESKTOP",
22        "page": 1,
23        "type": "organic",
24        "domain": "google.com",
25        "countryCode": "US",
26        "resultsPerPage": "10",
27        "title": "Python Release Python 3.13.0rc1",
28        "displayedUrl": "https://www.python.org › downloads › python-3130rc1",
29        "description": "2 days ago — Release Date: Aug. 1, 2024. This is the first release candidate of Python 3.13.0. This release, 3.13.0rc1, is the penultimate release preview.",
30        "emphasizedKeywords": "python site:python.org",
31        "siteLinks": [],
32        "position": 2
33    },
34    {
35        "term": "python site:python.org",
36        "url": "https://docs.python.org/3/library/functions.html",
37        "device": "DESKTOP",
38        "page": 1,
39        "type": "organic",
40        "domain": "google.com",
41        "countryCode": "US",
42        "resultsPerPage": "10",
43        "title": "Built-in Functions — Python 3.12.4 documentation",
44        "displayedUrl": "https://docs.python.org › library › functions",
45        "description": "3 days ago — The Python interpreter has a number of functions and types built into it that are always available. They are listed here in alphabetical order.,,,, Built-in ...",
46        "emphasizedKeywords": "python site:python.org",
47        "siteLinks": [],
48        "position": 3
49    },
50    ...
51]

Key Features

• Flexible Querying: Tailor your search with multiple parameters to get the most relevant results.
• JSON Format: Results are returned in a clean and structured JSON format, ready for further processing.
• Pagination Support: Retrieve multiple pages of Google search results effortlessly.
• Filtering Options: Use filters such as site-specific, language, country code, and more to refine your search.

This actor is highly customizable, making it an essential tool for those needing to automate and extract Google search data programmatically.