Search

Perform a full Google web search and receive structured results including organic listings, People Also Ask questions, and People Also Search For suggestions. Results are returned in clean JSON format with position tracking for SEO analysis.

HTTP Request

1
GET /search

Parameters

Parameter	Type	Required	Default	Description
`q`	string	Yes	—	The search query string
`num`	integer	No	`10`	Number of results to return (1-100)
`start`	integer	No	`0`	Result offset for pagination (0-based index)
`hl`	string	No	`"en"`	Language code for the search interface (e.g., `en`, `es`, `fr`)
`gl`	string	No	`"us"`	Country code for localized results (e.g., `us`, `uk`, `de`)

Response

The response returns a JSON object containing organic search results and related data.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
{
  "status": true,
  "request_id": "a35488c9-6d45-3b35-e7a4-f9e75acd",
  "data": {
    "organic_results": [
      {
        "title": "Pricing - OpenAI",
        "link": "https://openai.com/pricing",
        "description": "Simple and flexible. Only pay for what you use.",
        "position": 0,
        "domain": "openai.com",
        "displayed_link": "https://openai.com › pricing"
      },
      {
        "title": "OpenAI API Pricing Calculator",
        "link": "https://example.com/calculator",
        "description": "Calculate your estimated costs for using the OpenAI API.",
        "position": 1,
        "domain": "example.com",
        "displayed_link": "https://example.com › calculator"
      }
    ],
    "real_query": "openai api pricing",
    "people_also_ask": [
      "How much does OpenAI API cost?",
      "Is OpenAI API free to use?",
      "What is the rate limit for OpenAI API?"
    ],
    "people_also_search_for": [
      "openai api documentation",
      "chatgpt api pricing",
      "gpt-4 api cost"
    ]
  }
}

Response Fields

Field	Type	Description
`status`	boolean	Whether the request was successful
`request_id`	string	Unique identifier for the request
`data.real_query`	string	The actual query Google processed
`data.organic_results`	array	List of organic search results
`data.organic_results[].title`	string	Title of the search result
`data.organic_results[].link`	string	URL of the search result
`data.organic_results[].description`	string	Text description shown in the result
`data.organic_results[].position`	integer	Position of the result (0-based)
`data.organic_results[].domain`	string	Domain of the result URL
`data.organic_results[].displayed_link`	string	Display URL as shown by Google
`data.people_also_ask`	array	List of related questions from the People Also Ask box
`data.people_also_search_for`	array	List of related search queries

Code Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
import requests

url = "https://google-serp-search-api.p.rapidapi.com/search"

querystring = {
    "q": "openai api pricing",
    "num": "10",
    "start": "0",
    "hl": "en",
    "gl": "us"
}

headers = {
    "X-RapidAPI-Key": "YOUR_API_KEY",
    "X-RapidAPI-Host": "google-serp-search-api.p.rapidapi.com"
}

response = requests.get(url, headers=headers, params=querystring)
data = response.json()["data"]

for result in data["organic_results"]:
    print(f"{result['position']}. {result['title']}")
    print(f"   {result['link']}")
    print(f"   {result['description']}\n")

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
const url = "https://google-serp-search-api.p.rapidapi.com/search";

const params = new URLSearchParams({
  q: "openai api pricing",
  num: "10",
  start: "0",
  hl: "en",
  gl: "us",
});

const response = await fetch(`${url}?${params}`, {
  method: "GET",
  headers: {
    "X-RapidAPI-Key": "YOUR_API_KEY",
    "X-RapidAPI-Host": "google-serp-search-api.p.rapidapi.com",
  },
});

const { data } = await response.json();

data.organic_results.forEach((result) => {
  console.log(`${result.position}. ${result.title}`);
  console.log(`   ${result.link}`);
  console.log(`   ${result.description}\n`);
});

1
2
3
4
5
6
7
8
curl -G "https://google-serp-search-api.p.rapidapi.com/search" \
  --data-urlencode "q=openai api pricing" \
  --data-urlencode "num=10" \
  --data-urlencode "start=0" \
  --data-urlencode "hl=en" \
  --data-urlencode "gl=us" \
  -H "X-RapidAPI-Key: YOUR_API_KEY" \
  -H "X-RapidAPI-Host: google-serp-search-api.p.rapidapi.com"

Autocomplete — Get search autocomplete suggestions for a query

HTTP Request

Parameters

Response

Response Fields

Code Examples

Related Endpoints