> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hasdata.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Google Shopping API
The Google Shopping API gives real-time access to structured product listings from Google Shopping, with no blocks or CAPTCHAs.
## Get Your API Key
Sign in at [hasdata.com](https://app.hasdata.com/sign-in), go to your account settings, and copy your API key.
All requests must include your key in the `x-api-key` header.
## Request Cost and API Credits
Each request to the Google Shopping API consumes **API Credits** from your account balance.
* **Cost per request:** 10 API Credits
* Credits are deducted only for successful requests.
* Your total available credits depend on your active plan.
You can use your credits across all HasData APIs. The same credit balance is shared platform-wide.
**Unused credits do not roll over.** Any remaining credits expire at the end of the current billing period.
To monitor your credit usage and remaining balance, sign in to your account dashboard at [app.hasdata.com](https://app.hasdata.com/sign-in).
## Make Your First Request
```bash cURL theme={null}
curl --request GET -G \
--url 'https://api.hasdata.com/scrape/google/shopping' \
--data-urlencode 'q=Coffee' \
--data-urlencode 'location=Austin,Texas,United States' \
--data-urlencode 'deviceType=desktop' \
--header 'Content-Type: application/json' \
--header 'x-api-key: '
```
```bash HasData CLI theme={null}
hasdata google-shopping \
--q Coffee \
--location 'Austin,Texas,United States' \
--device-type desktop
```
```javascript Node.js theme={null}
const axios = require('axios').default;
const options = {
method: 'GET',
url: 'https://api.hasdata.com/scrape/google/shopping',
params: {q: 'Coffee', location: 'Austin,Texas,United States', deviceType: 'desktop'},
headers: {'Content-Type': 'application/json', 'x-api-key': ''}
};
try {
const { data } = await axios.request(options);
console.log(data);
} catch (error) {
console.error(error);
}
```
```python Python theme={null}
import requests
url = "https://api.hasdata.com/scrape/google/shopping"
querystring = {"q":"Coffee","location":"Austin,Texas,United States","deviceType":"desktop"}
headers = {
"Content-Type": "application/json",
"x-api-key": ""
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())
```
```php PHP theme={null}
"Coffee",
"location" => "Austin,Texas,United States",
"deviceType" => "desktop",
];
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.hasdata.com/scrape/google/shopping?" . http_build_query($params),
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: ",
],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;
```
```java Java theme={null}
OkHttpClient client = new OkHttpClient();
HttpUrl url = HttpUrl.parse("https://api.hasdata.com/scrape/google/shopping")
.newBuilder()
.addQueryParameter("q", "Coffee")
.addQueryParameter("location", "Austin,Texas,United States")
.addQueryParameter("deviceType", "desktop")
.build();
Request request = new Request.Builder()
.url(url)
.get()
.addHeader("Content-Type", "application/json")
.addHeader("x-api-key", "")
.build();
Response response = client.newCall(request).execute();
```
```csharp C# theme={null}
using System.Net.Http;
using System.Web;
var client = new HttpClient();
var query = HttpUtility.ParseQueryString(string.Empty);
query["q"] = "Coffee";
query["location"] = "Austin,Texas,United States";
query["deviceType"] = "desktop";
var url = $"https://api.hasdata.com/scrape/google/shopping?{query}";
var request = new HttpRequestMessage(new HttpMethod("GET"), url);
request.Headers.Add("x-api-key", "");
using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
var content = await response.Content.ReadAsStringAsync();
Console.WriteLine(content);
```
```ruby Ruby theme={null}
require 'net/http'
require 'uri'
uri = URI("https://api.hasdata.com/scrape/google/shopping")
params = {
"q" => "Coffee",
"location" => "Austin,Texas,United States",
"deviceType" => "desktop",
}
uri.query = URI.encode_www_form(params)
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request["Content-Type"] = 'application/json'
request["x-api-key"] = ''
response = http.request(request)
puts response.read_body
```
```rust Rust theme={null}
use reqwest::blocking::Client;
fn main() -> Result<(), Box> {
let client = Client::new();
let res = client
.get("https://api.hasdata.com/scrape/google/shopping")
.query(&[("q", "Coffee")])
.query(&[("location", "Austin,Texas,United States")])
.query(&[("deviceType", "desktop")])
.header("Content-Type", "application/json")
.header("x-api-key", "")
.send()?
.text()?;
println!("{}", res);
Ok(())
}
```
```go Go theme={null}
package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
params := url.Values{}
params.Set("q", "Coffee")
params.Set("location", "Austin,Texas,United States")
params.Set("deviceType", "desktop")
u := "https://api.hasdata.com/scrape/google/shopping?" + params.Encode()
req, _ := http.NewRequest("GET", u, nil)
req.Header.Add("Content-Type", "application/json")
req.Header.Add("x-api-key", "")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}
```
## API Parameters
| Parameter | Default Value | Required | Description |
| ------------ | -------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `q` | Coffee | Yes | Specify the search term for which you want to scrape the SERP. |
| `location` | Austin,Texas,United States | No | Google canonical location for the search. |
| `uule` | - | No | The encoded location parameter. |
| `domain` | - | No | Google domain to use. Default is google.com. |
| `gl` | - | No | The two-letter country code for the country you want to limit the search to. |
| `hl` | - | No | The two-letter language code for the language you want to use for the search. |
| `tbs` | - | No | This parameter supports various filters that can be combined by separating them with a comma. Here are examples of these filters:
- Specific Time Range: `cdr:1,cd_min:10/17/2018,cd_max:3/8/2021` - Filter results to show only those within the defined date range.
- Sort by Date: `sbd:1` - Results are sorted by date, from the most recent to the oldest.
- Sort by Relevance: `sbd:0` - Results are sorted by relevance to the search query.
- Sites with Images: `img:1` - Only show results from webpages that contain images.
Quick Date Range (qdr):
- `qdr:h` - Show results from the past hour.
- `qdr:d` - Limit results to the past day.
- `qdr:w` - Filter results from the week.
- `qdr:m` - Display results from the past month.
- `qdr:y` - Show results from the past year.
- `qdr:h10`, `qdr:d10`, `qdr:w10`, `qdr:m10`, `qdr:y10` - Specify a number to show results from the last 10 hours, days, weeks, months, or years respectively.
These filters enhance the control over search results, allowing for precise retrieval of information based on specific criteria.
|
| `shoprs` | - | No | Specifies the helper ID for applying search filters. Must be used with the updated `q` parameter, which includes the selected filter (e.g., Coffee sale).
To apply filters, use the `hasdata_link` from `filters[index].options[index]` in the JSON. Apply multiple filters by following each `hasdata_link` one by one.
To remove a filter, follow its specific `hasdata_link`.
|
| `deviceType` | desktop | No | Specify the device type for the search. |
| `start` | - | No | This parameter specifies the number of search results to skip and is used for implementing pagination. For example, a value of 0 (default) indicates the first page of results, 40 refers to the second page, and 80 to the third page.
|