Google Search API

prod-global

GET

/api/v1/google/search

API health status

Healthy Available Limited Mostly unavailable No data

Loading health status...

Get Google search SERP data, including organic results, ads, and knowledge panels, for keyword tracking and SERP analysis across markets.

Tags: Google

Parameters

Name	Required	Type	Default	Description
query	Yes	string		The search query for Google Search (e.g., 'coffee shops', 'how to bake a cake').
page	No	integer	0	The results page number. Use 0 for the first page, 1 for the second, and so on.
html	No	boolean	false	Set to true to return the raw HTML of the Google search results page alongside the structured data.
language	No	string	en	Set the language for the results using its two-letter code (e.g., 'en' for English, 'fr' for French). See Google Language.
lr	No	string		Restrict results to one or more languages using the 'lang_{language_code}' format (e.g., 'lang_en'). See Google LR Language.
domain	No	string	google.com	The Google domain to use for the search (e.g., 'google.com', 'google.co.uk'). See Google Domains.
country	No	string	us	Set the target country code (e.g., 'us', 'uk') to localize results. See Google Countries.
cr	No	string		Limits results to search results from specific countries. Format: 'countryXX'. See Google CR Countries.
uule	No	string		Encoded location string (UULE) used to precisely localize Google search results. This is an advanced/technical parameter — if you’re not familiar with it, you can leave it empty and omit it.
location	No	string		The textual location name (e.g., 'New York, NY') to localize the search results.
ludocid	No	string		Google local business CID (place identifier). Used to target a specific Google Business Profile / local listing. Advanced parameter — if you don’t know it, you can omit it.
lsig	No	string		Signature parameter (lsig) sometimes required for certain Knowledge Graph / local map view features. This is an advanced technical parameter — if you’re not familiar with it, you can leave it empty.
kgmid	No	string		Knowledge Graph entity/listing ID (KGMID) used to retrieve details for a specific entity. This is an advanced technical parameter — if you’re not familiar with it, you can leave it empty.
si	No	string		Cached search context parameter (si) used to reproduce specific Google search result views/context (e.g. some Knowledge Graph tabs). This is an advanced technical parameter — if you’re not familiar with it, you can leave it empty.
ibp	No	string		Parameter (ibp) used to control certain Google UI expansions or rendering modes (commonly in local/business result views). This is an advanced technical parameter — if you’re not familiar with it, you can leave it empty.
uds	No	string		Advanced filter token (uds) used for specific Google search sub-filters. This is an advanced technical parameter, usually provided by Google in filter options/results — if you’re not familiar with it, you can leave it empty.
tbs	No	string		Advanced search filter parameter (tbs) used to apply Google result filters (e.g. time range). This is an advanced parameter — if you’re not familiar with it, you can leave it empty.
safe	No	string	off	SafeSearch filter setting. Set to 'active' to filter adult content, or 'off' to disable it.
nfpr	No	string	0	Controls Google's auto-correction. Set to '1' to exclude corrected results, '0' to include them.
filter	No	string		Toggle 'Similar Results' and 'Omitted Results' filters. Set to '1' (default) to enable, '0' to disable.

Copy Request

cURL

curl -X GET "https://api.justserpapi.com/api/v1/google/search?query=coffee" \
  -H "X-API-Key: YOUR_API_KEY"

JavaScript

const res = await fetch("https://api.justserpapi.com/api/v1/google/search?query=coffee", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await res.json();
console.log(data);

Python

import requests

url = "https://api.justserpapi.com/api/v1/google/search"
headers = { "X-API-Key": "YOUR_API_KEY" }
params = {
  "query": "coffee"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

PHP

<?php
$url = "https://api.justserpapi.com/api/v1/google/search?query=coffee";
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "X-API-Key: YOUR_API_KEY"
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

Go

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	client := &http.Client{}
	req, _ := http.NewRequest("GET", "https://api.justserpapi.com/api/v1/google/search?query=coffee", nil)
	req.Header.Set("X-API-Key", "YOUR_API_KEY")
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

Response

Loading the latest response example...