> ## 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 Images API
Provides real-time access to Google image search results, tailored to specific parameters, ensuring efficient retrieval free from 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 Images API consumes **API Credits** from your account balance.
* **Cost per request:** 5 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/images' \
--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-images \
--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/images',
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/images"
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/images?" . 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/images")
.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/images?{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/images")
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/images")
.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/images?" + 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 | Search query term for retrieving image results. |
| `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 | `tbs` parameter for the Google Images API customizes image search results with various filters that can be combined using commas. Here are the available options:
Image Size Filters:
- `isz:l` - Search for large images.
- `isz:m` - Search for medium images.
- `isz:i` - Search for icon-sized images.
- `isz:lt,islt:qsvga` - Filter for images larger than 400×300.
- `isz:lt,islt:vga` - Filter for images larger than 640×480.
- `isz:lt,islt:svga` - Filter for images larger than 800×600.
- `isz:lt,islt:xga` - Filter for images larger than 1024×768.
- `isz:lt,islt:2mp` - Filter for images larger than 1600×1200.
- `isz:lt,islt:4mp` - Filter for images larger than 2272×1704.
- `isz:ex,iszw:1000,iszh:1000` - Search for images exactly 1000×1000.
Color Filters:
- `ic:color` - Search for full-color images.
- `ic:gray` - Search for black and white images.
- `ic:specific,isc:red` (and other colors such as orange, yellow, green, etc.) - Search for images predominantly in specified colors.
Image Type Filters:
- `itp:face` - Search for images of faces.
- `itp:photo` - Search for photographs.
- `itp:clipart` - Search for clipart images.
- `itp:lineart` - Search for line drawings.
- `itp:animated` - Search for animated images (GIFs).
|
| `safe` | - | No | Adult Content Filtering option. |
| `filter` | - | No | Defines whether to enable or disable the filters for 'Similar Results' and 'Omitted Results'. Set to 1 (default) to enable these filters, or 0 to disable them.
|
| `deviceType` | desktop | No | Specify the device type for the search. |
| `ijn` | - | No | Page number for paginated results, where 0 is the first page. |