hartator/google-search-results-python

Google Search Results via SERP API pip Python Package

Google Search Results in Python

This Python package is meant to scrape and parse Google results using SERP API. Feel free to fork this repository to add more backends.

Simple Example

from lib.google_search_results import GoogleSearchResults
query = GoogleSearchResults({"q": "coffee"})
html_results = query.get_html()

Set SERP API key

GoogleSearchResults.SERP_API_KEY = "Your Private Key"

Or

query = GoogleSearchResults({"q": "coffee", "serp_api_key": "Your Private Key"})

Example with all params and all outputs

query_params = {
  "q": "query",
  "google_domain": "Google Domain",
  "location": "Location Requested",
  "device": device,
  "hl": "Google UI Language",
  "gl": "Google Country",
  "safe": "Safe Search Flag",
  "num": "Number of Results",
  "start": "Pagination Offset",
  "serp_api_key": "Your SERP API Key"
}

query = GoogleSearchResults(query_params)
query.params_dict["location"] = "Portland"

html_results = query.get_html()
dictionary_results = query.get_dictionary()
dictionary_results_with_images = query.get_dictionary_with_images()
json_results = query.get_json()
json_results_with_images = query.get_json_with_images()

Example of Python Dictionary Output (GoogleSearchResults#get_dictionary)