# Google Search API Here is the list of default parameters you can use with this API :

Parameters	Description
api_key required	This is your API key.
q required	Type: `String` Google Search Query
num	Type: `Number(Integer)` Number of results per page
gl	Type: `String` Default: `"us"` Name of the country. The name should be in ISO 3166 Alpha-2 format.
hl	Type: `String` Default Value: `"en_us"` The language of the requested results.
page	Type: `Number(Integer)` `[0,10,20....]` Default: `0` (Enter 10 for 2nd-page results, 20 for 3rd, etc .) The page number to get targeted search results.
lr	Type: `String` Limit the search to one or multiple languages. It is used as `lang_{language code}`. For example - "lang_us".
uule	Type: `String` Used to encode a place an exact location(with latitude and longitude) into a value used in a cookie, an URL, or an HTTP header.
duration	Type: `String` Use this as `"d/w/m/mn/y"` where n is from `0-10`. `d` - the previous 24 hours, `w` - the previous seven days, `m` - the previous month, `mn` - the previous n number of months, `y` - past year The `duration` parameter requests search results from a specified time period (quick date range).
nfpr	Type: `Boolean` Default: `0` It excludes the result from an auto-corrected query that is spelled wrong. It can be set to `1` to exclude these results or `0` to include them.
tbs	Type: `String` to be searched - An advanced parameter to filter search results.
safe	Type: String `[active/off]` Default: `off` To filter the adult content set `safe` to `active` or to disable it set it `off`.
domain	Type: `String` Default: `"google.com"` To obtain local results from a specific country, for example, for India, it will be "google.co.in," and for the UK, it will be "google.co.uk."
html	Type: `Boolean` Default: `false` To render response as raw HTML.

**Note: Serpdog supports two APIs:** 1. **LITE Google Search API** - To get results rapidly with fewer featured snippets. It costs half the advanced search API. 2. **Advanced Google Search API** - To get advanced featured snippets but with a difference in speed. ### LITE Google Search API Example: {% tabs %} {% tab title="cURL" %} ```json cURL "https://api.serpdog.io/lite_search?api_key=APIKEY&q=coffee&gl=us" ``` {% endtab %} {% tab title="Node JS" %} ```javascript const axios = require('axios'); axios.get('https://api.serpdog.io/lite_search?api_key=APIKEY&q=coffee&gl=us') .then(response => { console.log(response.data); }) .catch(error => { console.log(error); }); ``` {% endtab %} {% tab title="Python" %} ```python import requests payload = {'api_key': 'APIKEY', 'q':'coffee' , 'gl':'us'} resp = requests.get('https://api.serpdog.io/lite_search', params=payload) print (resp.text) ``` {% endtab %} {% tab title="Java" %} ```java try { String url = "https://api.serpdog.io/lite_search?api_key=APIKEY&q=coffee&gl=us"; URL urlForGetRequest = new URL(url); String readLine = null; HttpURLConnection conection = (HttpURLConnection) urlForGetRequest.openConnection(); conection.setRequestMethod("GET"); int responseCode = conection.getResponseCode(); if (responseCode == HttpURLConnection.HTTP_OK) { BufferedReader in = new BufferedReader(new InputStreamReader(conection.getInputStream())); StringBuffer response = new StringBuffer(); while ((readLine = in.readLine()) != null) { response.append(readLine); } in.close(); System.out.println(response.toString()); } else { throw new Exception("Error in API Call"); } } catch (Exception ex) { ex.printStackTrace(); } ``` {% endtab %} {% tab title="Ruby" %} ```ruby require 'net/http' require 'json' params = { :api_key => "APIKEY", :q=> "coffee", :gl => "us" } uri = URI('https://api.serpdog.io/lite_search') uri.query = URI.encode_www_form(params) website_content = Net::HTTP.get(uri) print(website_content) ``` {% endtab %} {% tab title="PHP" %} ```php { console.log(response.data); }) .catch(error => { console.log(error); }); ``` {% endtab %} {% tab title="Python" %} ```python import requests payload = {'api_key': 'APIKEY', 'q':'coffee' , 'gl':'us'} resp = requests.get('https://api.serpdog.io/search', params=payload) print (resp.text) ``` {% endtab %} {% tab title="Java" %} ```java try { String url = "https://api.serpdog.io/search?api_key=APIKEY&q=coffee&gl=us"; URL urlForGetRequest = new URL(url); String readLine = null; HttpURLConnection conection = (HttpURLConnection) urlForGetRequest.openConnection(); conection.setRequestMethod("GET"); int responseCode = conection.getResponseCode(); if (responseCode == HttpURLConnection.HTTP_OK) { BufferedReader in = new BufferedReader(new InputStreamReader(conection.getInputStream())); StringBuffer response = new StringBuffer(); while ((readLine = in.readLine()) != null) { response.append(readLine); } in.close(); System.out.println(response.toString()); } else { throw new Exception("Error in API Call"); } } catch (Exception ex) { ex.printStackTrace(); } ``` {% endtab %} {% tab title="Ruby" %} ```ruby require 'net/http' require 'json' params = { :api_key => "APIKEY", :q=> "coffee", :gl => "us" } uri = URI('https://api.serpdog.io/search') uri.query = URI.encode_www_form(params) website_content = Net::HTTP.get(uri) print(website_content) ``` {% endtab %} {% tab title="PHP" %} ```php --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.serpdog.io/google-search-api.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.