Google Search Scraper

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

{
  "query": "python programming",
  "num_pages": 2,
  "site_filter": "python.org",
  "country_code": "US",
  "language": "en",
  "search_type": "news",
  "date_range": "w",
  "safe_search": true
}

Example Output

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

[
     {
        "term": "python site:python.org",
        "url": "https://docs.python.org/",
        "device": "DESKTOP",
        "page": 1,
        "type": "organic",
        "domain": "google.com",
        "countryCode": "US",
        "resultsPerPage": "10",
        "title": "3.12.4 Documentation",
        "displayedUrl": "https://docs.python.org",
        "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 ...",
        "emphasizedKeywords": "python site:python.org",
        "siteLinks": [],
        "position": 1
    },
    {
        "term": "python site:python.org",
        "url": "https://www.python.org/downloads/release/python-3130rc1/",
        "device": "DESKTOP",
        "page": 1,
        "type": "organic",
        "domain": "google.com",
        "countryCode": "US",
        "resultsPerPage": "10",
        "title": "Python Release Python 3.13.0rc1",
        "displayedUrl": "https://www.python.org › downloads › python-3130rc1",
        "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.",
        "emphasizedKeywords": "python site:python.org",
        "siteLinks": [],
        "position": 2
    },
    {
        "term": "python site:python.org",
        "url": "https://docs.python.org/3/library/functions.html",
        "device": "DESKTOP",
        "page": 1,
        "type": "organic",
        "domain": "google.com",
        "countryCode": "US",
        "resultsPerPage": "10",
        "title": "Built-in Functions — Python 3.12.4 documentation",
        "displayedUrl": "https://docs.python.org › library › functions",
        "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 ...",
        "emphasizedKeywords": "python site:python.org",
        "siteLinks": [],
        "position": 3
    },
    ...
]

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.