Google Search API

Google Search API

/search API endpoint allows you to scrape the results from Google search engine via our SerpApi service.

Api Details

Endpoint GET https://serpapi.abcproxy.com/search

📌 Description Retrieve comprehensive user profile including basic info, account status and optional permission sets.

---

Request

HTTP Request

---

cURL

curl -X GET "https://serpapi.abcproxy.com/search" \
  -d "engine=google" \
  -d "q=Coffee" \
  -d "no_cache=false" \
  -d "api_key=YOUR_API_KEY"

Python

import requests

params = {
    "engine": "google",
    "q": "Coffee",
    "no_cache": "false",
    "api_key": "YOUR_API_KEY"
}
response = requests.get("https://serpapi.abcproxy.com/search", params=params)
print(response.json())

Node.js

const axios = require('axios');

const params = {
  engine: "google",
  q: "Coffee",
  no_cache: "false",
  api_key: "YOUR_API_KEY"
};

axios.get("https://serpapi.abcproxy.com/search", { params })
  .then(response => console.log(response.data));

HTTP

GET /search?engine=google&q=Coffee&no_cache=false&api_key=YOUR_API_KEY HTTP/1.1
Host: serpapi.abcproxy.com

PHP

<?php
$client = new \GuzzleHttp\Client();
$response = $client->get('https://serpapi.abcproxy.com/search', [
    'query' => [
        'engine' => 'google',
        'q' => 'Coffee',
        'no_cache' => 'false',
        'api_key' => 'YOUR_API_KEY'
    ]
]);
echo $response->getBody();

Golang

package main

import (
    "net/http"
    "io/ioutil"
    "log"
)

func main() {
    client := &http.Client{}
    req, _ := http.NewRequest("GET", "https://serpapi.abcproxy.com/search", nil)
    
    q := req.URL.Query()
    q.Add("engine", "google")
    q.Add("q", "Coffee")
    q.Add("no_cache", "false")
    q.Add("api_key", "YOUR_API_KEY")
    req.URL.RawQuery = q.Encode()

    resp, _ := client.Do(req)
    body, _ := ioutil.ReadAll(resp.Body)
    log.Println(string(body))
}

C#

using System;
using System.Net.Http;

class Program
{
    static async Task Main()
    {
        var client = new HttpClient();
        var query = System.Web.HttpUtility.ParseQueryString(string.Empty);
        query["engine"] = "google";
        query["q"] = "Coffee";
        query["no_cache"] = "false";
        query["api_key"] = "YOUR_API_KEY";
        
        var response = await client.GetAsync(
            $"https://serpapi.abcproxy.com/search?{query}"
        );
        Console.WriteLine(await response.Content.ReadAsStringAsync());
    }
}

Java

import java.net.*;
import java.io.*;

public class Main {
    public static void main(String[] args) throws Exception {
        String url = "https://serpapi.abcproxy.com/search" +
            "?engine=google" +
            "&q=Coffee" +
            "&no_cache=false" +
            "&api_key=YOUR_API_KEY";
        
        HttpURLConnection conn = (HttpURLConnection) new URL(url).openConnection();
        conn.setRequestMethod("GET");
        
        BufferedReader in = new BufferedReader(
            new InputStreamReader(conn.getInputStream())
        );
        String response = in.lines().collect(Collectors.joining());
        System.out.println(response);
    }
}

---

API Parameters

Search Query

Name	Type	Required	Description	Example
q	string	Yes	query parameter	coffee

Geographic Location

Name	Type	Required	Description	Example
location	string	No	Parameter defines from where you want the search to originate. If several locations match the location requested, we'll pick the most popular one.Head to the locations API if you need more precise control. The location and uule parameters can't be used together. If location is omitted, the search may take on the location of the proxy.	Japan-Tokyo
uule	string	No	Search using a Google-coded location.uule and location parameters can't be used together.	-

Advanced Google Parameters

Name	Type	Required	Description	Example
ludocid	string	No	Define the ID (CID) of the Google My Business list to crawl	-
lsig	string	No	Parameters used to force the display of the knowledge graph map view.You can find the lsig ID by using our Local Pack API or Google Local API. lsig ID is also available via a redirect Google uses within Google My Business.	-
kgmid	string	No	Define the ID of the Google Knowledge Graph list to crawl (KGMID),Searches using the kgmid parameter will return the results of the original encrypted search parameter. For some searches, kgmid may override all other parameters except the start and num parameters	-
si	string	No	Define cached search parameters for the Google search to be crawled	-
ibp	string	No	Responsible for rendering the layout and extension of certain elements	-
uds	string	No	Parameters used to filter the search. It is a string filter provided by Google. uds values are provided in the filters section, and each filter provides uds, q, and serpapi_link values.	-

Localization

Name	Type	Required	Description	Example
google_domain	string	No	That is, the parameter defines the Google domain to use. The default is google.com.Head to the Google domains page for a full list of supported Google domains.	-
gl	string	No	Simulating local searches can improve the relevance of country-specific search results. The gl parameter value is the two-letter country code.Head to the Google countries page for a full list of supported Google countries.	Amgola-ao
hl	string	No	The host language specifies the user interface (UI) language for Google Search.Head to the Google languages page for a full list of supported Google languages.	Akan-ak
cr	string	No	country restrict, which specifies that search results are restricted to websites/pages in a specific country or region.Head to the Google cr countries page for a full list of supported countries.	countryDE
lr	string	No	language restrict, which specifies that the search results are for websites/pages in a certain language. Head to the Google lr languages page for a full list of supported languages.	lang_fr

Advanced Filters

Name	Type	Required	Description	Example
tbs	string	No	The (to be searched) parameter defines advanced search parameters that are not possible in regular query fields. (For example, advanced searches for patents, dates, news, videos, images, apps, or text content)	advanced searches for patents
safe	string	No	Parameter defines the filtering level for adult content	activeoroff
nfpr	boolean	No	This parameter defines the automatic correction of excluded results from the query when the original query is misspelled	trueorfalse
filter	boolean	No	The parameter defines whether the "Similar Results" and "Omit Results" filters are turned on or offtrueorfalse	trueorfalse

Pagination

Name	Type	Required	Description	Example
start	int	No	The start index of the search results, specifying the first match that should be included in the search results .Google Local Results only accepts multiples of 20(e.g. 20 for the second page results, 40 for the third page results, etc.) as the start value.	0
num	int	No	Limit the number of results Specifies the number of search results to be displayed in a SERP page. The use of num may introduce latency, and/or prevent the inclusion of specialized result types. It is better to omit this parameter unless it is strictly necessary to increase the number of results per page. Results are not guaranteed to have the number of results specified in num	10

Serpapi Parameters

Name	Type	Required	Description	Example
engine	string	Yes	Set parameter to google (default) to use the Google API engine.	google
no_cache	boolean	No	Parameter will force SerpApi to fetch the Google results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month. It can be set to false (default) to allow results from the cache, or true to disallow results from the cache. no_cache and async parameters should not be used together.	trueorfalse
api_key	string	Yes	Parameter defines the SerpApi private key to use.	YOUR_API_KEY

---

Response

Success 200

Response Body

{
  "code": 200,
  "search_metadata":
    {
        "id":"8a446ec6-522d-4a37-b4b8-dc28e9413ac6",
        "json_endpoint":"https://webserp.abcproxy.com/files/2ae5d93f43d905ea/8a446ec6-522d-4a37-b4b8-dc28e9413ac6.json",
        "created_at":"2025-04-02 09:21:16",
        "google_url":"https://www.google.com/search?filter=0&ie=UTF-8&oe=UTF-8&oq=Coffee12&q=Coffee12&sourceid=chrome",
        "raw_html_file":"https://webserp.abcproxy.com/files/2ae5d93f43d905ea/8a446ec6-522d-4a37-b4b8-dc28e9413ac6.html",
        "xray_html_file":"https://webserp.abcproxy.com/files/2ae5d93f43d905ea/8a446ec6-522d-4a37-b4b8-dc28e9413ac6.xray",
        "total_time_taken":"9.2197",
    },
  "search_parameters":
    {
        "engine":"google",
        "q":"Coffee",
        "location_requested":"Austin, Texas, United States",
        "location_used":"Austin,Texas,United States",
        "google_domain":"google.com",
        "api_key":"YOUR_API_KEY",
        "hl":"en",
        "gl":"us",
    },
    "organic_results":
	[
        {
        "rank":1,
        "title":"Coffee",
        "url":"https://en.wikipedia.org/wiki/Coffee",
        "site_links":
            {
            "url":"https://en.wikipedia.org/wiki/Coffee_bean",
            "title":"Coffee bean",
            },
        "origin_site":"Wikipedia",
        "img":
            {
                "1":"https://encrypted-tbn0.gstati......h_CyKzA7hfwZKo&usqp=CAE&s",
            },
        }
		......
	],
	"shopping_results_ads":
    [
        {
        "url":"https://www.amazon.com.br/Caffeine-Army-Supercoffee-Original-.....mid=A301RVPME31WTN",
        "title":"Supercoffee Original/Tradicional - Economic Size (380g) - Caffeine ArmySupercoffee Original/Tradicional - Economic Size (380g) - Caffeine Army",
        "description":"Amazon.com.brAmazon.com.br",
        "price":"208,00 R$",
        }
        ......
    ]
  }
}

Response Fields

Name	Type	Remark
ads	object []	Sponsorsearch results
ai_overview	object	AI response
albums	object []	Albums
also_ask	object []	Other users' questions
answer_box	object	Question box
available_on	object []	Available on playback service providers, usually appears when searching for movies
buying_guide	object []	Buying guide
cast	object []	Role
complementary_results	object []	Small introduction labels for people – top right corner
discussions_and_forums	object []	Discussions and forums
dmca_messages	object []	Copyright notices at the bottom
episode_guide	object []	Episode guides
events_results	object []	Nearby events
filters	object []	Filters at the top of the webpage
find_results_on	object []	Search results on the website
grammar_check	object []	Syntax check message
hereto	object []	Related introductions
immersive_products	object []	Immersive product lists
inline_images	object []	Images in search results
jobs_results	object []	Job search related results
knowledge_graph	object []	Knowledge graph
local_map	object []	Map image links
local_results	object []	Merchant information locations
menu_highlights	object []	Menu highlights
movies	object []	Movie-related
organic_results	object []	Common data in search results
pagination	object	Pagination
perspectives	object []	Perspectives
places_sit	object []	About NFL
places_sites	object []	Recipes results – place names
players	object []	Athletes
popular_destinations	object []	Popular destinations
product_sites	object []	Product websites
questions_and_answers	object []	A set of questions and corresponding answers that address questions about a particular topic or area
recipes_results	object []	Recipes results
refine_this_search	object []	Refine this search – classifications at the top of the webpage
related_brands	object []	People also buy from
related_categories	object []	Related categories, appears when searching for cars – Explore more
related_searches	object	omitempty. If the field value is zero or a null reference, the corresponding key-value pair will not be created in JSON
scholarly_articles	object []	Scholarly articles
search_information	object	Search information
search_metadata	object	Contains timing and status information
search_parameters	object	Merchant details and location information
shopping_results	object []	Online Shopping
shopping_results_ads	object []	Sponsored ads
showtimes	object []	Showtimes Results, appears when searching for currently screening movies
songs	object []	Songs
sports_results	object []	Sports event information
things_to_know	object []	What other users think
top_sights	object []	Top news
top_stories	object []	Top stories
total_results_count	integer	Total search results count
tvShows	object []	TV show-related
twitter_results	object []	Twitter results
url	string	The search parameters of the user
videos	object []	Videos in search results

Error Responses

Common Errors

HTTP Status	Error Code	Description
200	400	API Key can not be empty
200	401	Param error
200	402	API Key error
200	403	Insufficient Balance
200	404	Deduction failed
200	405	Failed to record usage count
200	406	Unsupported engine
200	407	Network error
200	408	File not found
200	409	Limit param error
200	410	Build url error
200	411	Failed to QueryRecentRecord
200	412	Failed to find json
200	413	Get html error
200	414	HTML is empty
200	429	Too many request

Error Example

{
  "code": 400,
  "message": "API Key can not be empty"
}

---