# Google Shopping 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.
|
| html | Type: Boolean
Default: false
To render response as raw HTML.
|
### API Example:
{% tabs %}
{% tab title="cURL" %}
```json
cURL "https://api.serpdog.io/shopping?api_key=APIKEY&q=shoes&gl=us"
```
{% endtab %}
{% tab title="Node JS" %}
```javascript
const axios = require('axios');
axios.get('https://api.serpdog.io/shopping?api_key=APIKEY&q=shoes&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':'shoes' , 'gl':'us'}
resp = requests.get('https://api.serpdog.io/shopping', params=payload)
print (resp.text)
```
{% endtab %}
{% tab title="Java" %}
```java
try {
String url = "https://api.serpdog.io/shopping?api_key=APIKEY&q=shoes&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=> "shoes",
:gl => "us"
}
uri = URI('https://api.serpdog.io/shopping')
uri.query = URI.encode_www_form(params)
website_content = Net::HTTP.get(uri)
print(website_content)
```
{% endtab %}
{% tab title="PHP" %}
```php
```
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.