Google Search API
  1. Endpoints
Google Search API
  • Parameter References
    • Google Domain Reference
    • Google gl Parameter Reference
    • Google hl Parameter Reference
    • Google cr Parameter Reference
    • Google lr Parameter Reference
  • Endpoints
    • /location
      GET
    • /search
      GET
  1. Endpoints

/search

GET
/search
/search API endpoint allows you to scrape the results from Google search engine.

Request

Authorization
Add parameter in header
x-rapidapi-key
Example:
x-rapidapi-key: ********************
Query Params
q
string 
required
Parameter defines the query you want to search. You can use anything that you would use in a regular Google search. e.g. inurl:, site:, intitle:. We also support advanced search query parameters such as as_dt and as_eq. See the full list of supported advanced search query parameters.
location
string 
optional
Parameter defines from where you want the search to originate. use with location_parameters_auto set to true to automatically use most matched location. Head to the /location endpoint if you whish to manually search and chooce location. The location and uule parameters can't be used together. It is recommended to specify location at the city level in order to simulate a real user’s search. If location is omitted, the search may take on the location of the proxy.
location_parameters_auto
string 
optional
Use to automatically set all localization (google_domain, uule, hl, gl) parameters based on location parameter
uule
string 
optional
Use this to manually set you localizatioan. Get uule value from /location endpoint. Leave blank if you wish to set automatically with location_parameters_auto.
google_domain
string 
optional
USe this to manually set google domain. Leave blank if you wish to set automatically with location_parameters_auto. Head to the Google domains page for a full list of supported Google domains.
gl
string 
optional
Parameter defines the country to use for the Google search. It's a two-letter country code. (e.g., us for the United States, uk for United Kingdom, or fr for France). Head to the Google countries page for a full list of supported Google countries.
hl
string 
optional
Parameter defines the language to use for the Google search. It's a two-letter language code. (e.g., en for English, es for Spanish, or fr for French). Head to the Google languages page for a full list of supported Google languages.
cr
string 
optional
Parameter defines one or multiple countries to limit the search to. It uses country{two-letter upper-case country code} to specify countries and | as a delimiter. (e.g., countryFR|countryDE will only search French and German pages). Head to the Google cr countries page for a full list of supported countries.
lr
string 
optional
Parameter defines one or multiple languages to limit the search to. It uses lang_{two-letter language code} to specify languages and | as a delimiter. (e.g., lang_fr|lang_de will only search French and German pages). Head to the Google lr languages page for a full list of supported languages.
tbs
string 
optional
(to be searched) parameter defines advanced search parameters that aren't possible in the regular query field. (e.g., advanced search for patents, dates, news, videos, images, apps, or text contents).
safe
string 
optional
Parameter defines the level of filtering for adult content. It can be set to active or off, by default Google will blur explicit content.
nfpr
string 
optional
Parameter defines the exclusion of results from an auto-corrected query when the original query is spelled wrong. It can be set to 1 to exclude these results, or 0 to include them (default). Note that this parameter may not prevent Google from returning results for an auto-corrected query if no other results are available.
filter
string 
optional
Parameter defines if the filters for 'Similar Results' and 'Omitted Results' are on or off. It can be set to 1 (default) to enable these filters, or 0 to disable these filters.
tbm
string 
optional
(to be matched) parameter defines the type of search you want to do. It can be set to:
(no tbm parameter): regular Google Search,
isch: Google Images API,
lcl - Google Local API
vid: Google Videos API,
nws: Google News API,
shop: Google Shopping API,
pts: Google Patents API,
or any other Google service.
start
string 
optional
Parameter defines the result offset. It skips the given number of results. It's used for pagination. (e.g., 0 (default) is the first page of results, 10 is the 2nd page of results, 20 is the 3rd page of results, etc.). 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.
num
string 
optional
Parameter defines the maximum number of results to return. (e.g., 10 (default) returns 10 results, 40 returns 40 results, and 100 returns 100 results).

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://g-search.p.rapidapi.com/search?q&location&location_parameters_auto&uule&google_domain&gl&hl&cr&lr&tbs&safe&nfpr&filter&tbm&start&num' \
--header 'x-rapidapi-key;'

Responses

🟢200OK
application/json
Body
status
integer 
required
data
object 
required
logo
object 
required
result_stat
string 
required
organic_results
array [object {3}] 
required
people_also_ask
array [object {4}] 
required
image_results
array[string]
required
video_results
array[string]
required
inline_products
array[string]
required
inline_twitter
array [object {2}] 
required
knowledge_graph
object 
required
section_with_header
object 
required
navigation
object 
required
top_section
object 
required
query
object 
required
local_results
object 
required
ads
object 
required
search_parameters
object 
required
Example
{
  "status": 200,
  "data": {
    "logo": {
      "url": "https://www.google.com/webhp?hl=en&ictx=2&sa=X&ved=0ahUKEwjQq7auscyHAxUbGLkGHXcJEQEQPQgJ"
    },
    "result_stat": "About 585,000,000 results (0.81 seconds)",
    "organic_results": [
      {
        "title": "Joe Biden: The President",
        "url": "https://www.whitehouse.gov/administration/president-biden/",
        "desc": "President Biden represented Delaware for 36 years in the U.S. Senate before becoming the 47th Vice President of the United States. As President, Biden will ..."
      },
      {
        "title": "Joe Biden for President: Official Campaign Website",
        "url": "https://joebiden.com/",
        "desc": "Together, we can finish the job for the American people. Are you with us? Join our campaign to re-elect Joe Biden today!"
      },
      {
        "title": "Joe Biden (@joebiden) • Instagram photos and videos",
        "url": "https://www.instagram.com/joebiden/?hl=en",
        "desc": "17M Followers, 108 Following, 2890 Posts - Joe Biden (@ joebiden ) on Instagram: \"Husband to @DrBiden, proud father and grandfather."
      },
      {
        "title": "President Joe Biden",
        "url": "https://www.facebook.com/POTUS/",
        "desc": "President Joe Biden . 10M likes · 282114 talking about this. 46th President of the United States, husband to @FLOTUS, proud father and pop. Text me (302)..."
      },
      {
        "title": "Joe Biden",
        "url": "https://en.wikipedia.org/wiki/Joe_Biden",
        "desc": "11 hours ago — Joseph Robinette Biden Jr. (born November 20, 1942) is an American politician who is the 46th and current president of the United States since 2021.  Political positions ·  Family of Joe Biden ·  1988 presidential campaign ·  Beau Biden"
      },
      {
        "title": "Joe Biden",
        "url": "https://apnews.com/hub/joe-biden",
        "desc": "Stay informed and read the latest breaking news and updates on Joe Biden , the 46th president of the United States, from AP News, the definitive source for ..."
      },
      {
        "title": "potus - President Biden",
        "url": "https://twitter.com/potus",
        "desc": "46th President of the United States, husband to @FLOTUS, proud dad & pop. Tweets may be archived: https://t.co/HDhBZBkKpU Text me: (302) 404-0880."
      },
      {
        "title": "Joe Biden",
        "url": "https://www.facebook.com/joebiden/",
        "desc": "Joe Biden . 9825885 likes · 792907 talking about this. Husband to Dr. Biden, proud father and grandfather. Ready to finish the job for all Americans."
      },
      {
        "title": "President Joe Biden (@potus) • Instagram photos and videos",
        "url": "https://www.instagram.com/potus/?hl=en",
        "desc": "19M Followers, 5 Following, 4192 Posts - President Joe Biden (@potus) on Instagram: \"46th President of the United States, husband to @flotus, proud dad and ..."
      }
    ],
    "people_also_ask": [
      {
        "question": "How long has Biden been president?",
        "answer": "Joe Biden's tenure as the 46th president of the United States began with his inauguration on January 20, 2021.",
        "source": "https://en.wikipedia.org/wiki/Presidency_of_Joe_Biden#:~:text=Joe%20Biden's%20tenure%20as,inauguration%20on%20January%2020%2C%202021.",
        "source_title": "Presidency of Joe Biden - Wikipedia"
      },
      {
        "question": "What time is Biden in Austin?",
        "answer": "What time is Biden's speech Monday? Biden will deliver the keynote address in Austin at 4 p.m. Monday. 3 hours ago",
        "source": "https://www.statesman.com/story/news/state/2024/07/29/president-joe-biden-speech-lbj-library-austin-texas-how-to-watch-livestream-kamala-harris/74377745007/#:~:text=What%20time%20is%20Biden's%20speech,Austin%20at%204%20p.m.%20Monday.",
        "source_title": "President Biden to speak at LBJ Library in Austin on Monday"
      }
    ],
    "image_results": [],
    "video_results": [],
    "inline_products": [],
    "inline_twitter": [
      {
        "tweet": "With only 100 days until Election Day, we need all hands on deck to elect @KamalaHarris, defeat Donald Trump’s Project 2025 agenda, and protect our fundamental freedoms. Check your voter registration at IWillVote.com . Let’s get to work.",
        "url": "https://twitter.com/JoeBiden/status/1817689513587560858?ref_src=twsrc%5Egoogle%7Ctwcamp%5Eserp%7Ctwgr%5Etweet"
      },
      {
        "tweet": "Election Day is 100 days away and there’s never been more at stake. Let’s get @KamalaHarris to the White House.",
        "url": "https://twitter.com/JoeBiden/status/1817621566525481010?ref_src=twsrc%5Egoogle%7Ctwcamp%5Eserp%7Ctwgr%5Etweet"
      },
      {
        "tweet": "We just have to keep the faith and remember who we are. We are the UNITED States of America, and there is nothing beyond our capacity—when we do it together.",
        "url": "https://twitter.com/JoeBiden/status/1816268489432113249?ref_src=twsrc%5Egoogle%7Ctwcamp%5Eserp%7Ctwgr%5Etweet"
      },
      {
        "tweet": "The great thing about America is that here, kings and dictators do not rule.\n\nThe people do.\n\nHistory is in your hands.\n\nThe power is in your hands.\n\nThe idea of America lies in your hands.",
        "url": "https://twitter.com/JoeBiden/status/1816268306036449520?ref_src=twsrc%5Egoogle%7Ctwcamp%5Eserp%7Ctwgr%5Etweet"
      },
      {
        "tweet": "I have been privileged to serve this nation for over 50 years.\n\nI have given my heart and my soul, like so many others have.\n\nAnd I have been blessed a million times in return with the love and support of the American people.\n\nI hope you know how grateful I am to all of you.",
        "url": "https://twitter.com/JoeBiden/status/1816267744947417192?ref_src=twsrc%5Egoogle%7Ctwcamp%5Eserp%7Ctwgr%5Etweet"
      }
    ],
    "knowledge_graph": {
      "description": "Joseph Robinette Biden Jr. is an American politician who is the 46th and current president of the United States since 2021. A member of the Democratic Party, he served as the 47th vice president from 2009 to 2017 under President Barack Obama and represented Delaware in the U.S. Senate from 1973 to 2009.",
      "website": "https://www.whitehouse.gov/administration/president-biden/",
      "informations": [
        {
          "attribute": "kc:/people/person:born",
          "value": {
            "title": "Born",
            "desc": "November 20, 1942 (age 81 years), Scranton, PA"
          }
        },
        {
          "attribute": "kc:/government/politician:party",
          "value": {
            "title": "Party",
            "desc": "Democratic Party"
          }
        },
        {
          "attribute": "kc:/government/us_president:vice president",
          "value": {
            "title": "Vice president",
            "desc": "Kamala Harris (2021–)"
          }
        },
        {
          "attribute": "kc:/government/politician:presidential_term",
          "value": {
            "title": "Presidential term",
            "desc": "January 20, 2021 –"
          }
        },
        {
          "attribute": "kc:/people/person:spouse",
          "value": {
            "title": "Spouse",
            "desc": "Jill Biden (m. 1977), Neilia Hunter Biden (m. 1966–1972)"
          }
        },
        {
          "attribute": "kc:/people/person:children",
          "value": {
            "title": "Children",
            "desc": "Hunter Biden , Beau Biden , Ashley Biden , Naomi Christina Biden"
          }
        },
        {
          "attribute": "kc:/sports/pro_athlete:height",
          "value": {
            "title": "Height",
            "desc": "6′ 0″"
          }
        }
      ],
      "answer_panel": [],
      "social_media": [
        {
          "name": "X (Twitter)",
          "url": "https://twitter.com/JoeBiden"
        },
        {
          "name": "Facebook",
          "url": "https://www.facebook.com/joebiden"
        },
        {
          "name": "Instagram",
          "url": "https://www.instagram.com/potus"
        },
        {
          "name": "YouTube",
          "url": "https://www.youtube.com/joebiden"
        },
        {
          "name": "TikTok",
          "url": "https://www.tiktok.com/@bidenhq"
        }
      ]
    },
    "section_with_header": {
      "section_list": [
        {
          "title": "Biden rolls out plan to overhaul the Supreme Court",
          "url": "https://www.cnbc.com/2024/07/29/biden-rolls-out-plan-to-overhaul-the-supreme-court.html"
        },
        {
          "title": "Biden unveils a proposal to establish term limits for the Supreme Court",
          "url": "https://apnews.com/article/supreme-court-reform-biden-harris-trump-ffd48f3a2023aeca841bb53c2147ef03"
        },
        {
          "title": "'No one is above the law': Biden calls for sweeping Supreme Court reforms",
          "url": "https://www.usatoday.com/story/news/politics/2024/07/29/biden-supreme-court-reform-presidential-immunity-term-limits/74583088007/"
        },
        {
          "title": "Joe Biden is out and Kamala Harris is in. Disenchanted voters are taking a new look at their choices",
          "url": "https://www.yahoo.com/news/joe-biden-kamala-harris-disenchanted-114339228.html"
        },
        {
          "title": "Harris sees boost in favorability after Biden drops out of race: POLL",
          "url": "https://abcnews.go.com/Politics/harris-sees-boost-favorability-after-biden-drops-race/story?id=112306763"
        },
        {
          "title": "Election 2024 live updates: Harris' veepstakes heats up; Trump launches 'border czar' attacks",
          "url": "https://www.nbcnews.com/politics/2024-election/live-blog/trump-harris-presidential-election-live-updates-rcna164000"
        },
        {
          "title": "Donald Trump v Kamala Harris: what the polls say",
          "url": "https://www.economist.com/interactive/us-2024-election/trump-harris-polls"
        }
      ]
    },
    "navigation": {
      "current_page": "1",
      "other_pages": [
        {
          "page": "2",
          "url": "https://www.google.com/search?q=Joe+biden&sca_esv=07485e11c038ba95&sca_upv=1&gl=US&hl=en&ei=KJ2nZtD3J5uw5OUP95LECA&start=10&sa=N&sstk=Aagrsuj725R4-CJJbh5cksxMJCzTYMp6r1ULVx2RjjdO9KsGFtgw-I1u8CrtR7I24UfuJsm3pSE0-NAmEB892kWjjRtjr_v5xjFymw&ved=2ahUKEwjQq7auscyHAxUbGLkGHXcJEQEQ8tMDegQICBAE"
        },
        {
          "page": "3",
          "url": "https://www.google.com/search?q=Joe+biden&sca_esv=07485e11c038ba95&sca_upv=1&gl=US&hl=en&ei=KJ2nZtD3J5uw5OUP95LECA&start=20&sa=N&sstk=Aagrsuj725R4-CJJbh5cksxMJCzTYMp6r1ULVx2RjjdO9KsGFtgw-I1u8CrtR7I24UfuJsm3pSE0-NAmEB892kWjjRtjr_v5xjFymw&ved=2ahUKEwjQq7auscyHAxUbGLkGHXcJEQEQ8tMDegQICBAG"
        },
        {
          "page": "4",
          "url": "https://www.google.com/search?q=Joe+biden&sca_esv=07485e11c038ba95&sca_upv=1&gl=US&hl=en&ei=KJ2nZtD3J5uw5OUP95LECA&start=30&sa=N&sstk=Aagrsuj725R4-CJJbh5cksxMJCzTYMp6r1ULVx2RjjdO9KsGFtgw-I1u8CrtR7I24UfuJsm3pSE0-NAmEB892kWjjRtjr_v5xjFymw&ved=2ahUKEwjQq7auscyHAxUbGLkGHXcJEQEQ8tMDegQICBAI"
        },
        {
          "page": "5",
          "url": "https://www.google.com/search?q=Joe+biden&sca_esv=07485e11c038ba95&sca_upv=1&gl=US&hl=en&ei=KJ2nZtD3J5uw5OUP95LECA&start=40&sa=N&sstk=Aagrsuj725R4-CJJbh5cksxMJCzTYMp6r1ULVx2RjjdO9KsGFtgw-I1u8CrtR7I24UfuJsm3pSE0-NAmEB892kWjjRtjr_v5xjFymw&ved=2ahUKEwjQq7auscyHAxUbGLkGHXcJEQEQ8tMDegQICBAK"
        },
        {
          "page": "6",
          "url": "https://www.google.com/search?q=Joe+biden&sca_esv=07485e11c038ba95&sca_upv=1&gl=US&hl=en&ei=KJ2nZtD3J5uw5OUP95LECA&start=50&sa=N&sstk=Aagrsuj725R4-CJJbh5cksxMJCzTYMp6r1ULVx2RjjdO9KsGFtgw-I1u8CrtR7I24UfuJsm3pSE0-NAmEB892kWjjRtjr_v5xjFymw&ved=2ahUKEwjQq7auscyHAxUbGLkGHXcJEQEQ8tMDegQICBAM"
        },
        {
          "page": "7",
          "url": "https://www.google.com/search?q=Joe+biden&sca_esv=07485e11c038ba95&sca_upv=1&gl=US&hl=en&ei=KJ2nZtD3J5uw5OUP95LECA&start=60&sa=N&sstk=Aagrsuj725R4-CJJbh5cksxMJCzTYMp6r1ULVx2RjjdO9KsGFtgw-I1u8CrtR7I24UfuJsm3pSE0-NAmEB892kWjjRtjr_v5xjFymw&ved=2ahUKEwjQq7auscyHAxUbGLkGHXcJEQEQ8tMDegQICBAO"
        },
        {
          "page": "8",
          "url": "https://www.google.com/search?q=Joe+biden&sca_esv=07485e11c038ba95&sca_upv=1&gl=US&hl=en&ei=KJ2nZtD3J5uw5OUP95LECA&start=70&sa=N&sstk=Aagrsuj725R4-CJJbh5cksxMJCzTYMp6r1ULVx2RjjdO9KsGFtgw-I1u8CrtR7I24UfuJsm3pSE0-NAmEB892kWjjRtjr_v5xjFymw&ved=2ahUKEwjQq7auscyHAxUbGLkGHXcJEQEQ8tMDegQICBAQ"
        },
        {
          "page": "9",
          "url": "https://www.google.com/search?q=Joe+biden&sca_esv=07485e11c038ba95&sca_upv=1&gl=US&hl=en&ei=KJ2nZtD3J5uw5OUP95LECA&start=80&sa=N&sstk=Aagrsuj725R4-CJJbh5cksxMJCzTYMp6r1ULVx2RjjdO9KsGFtgw-I1u8CrtR7I24UfuJsm3pSE0-NAmEB892kWjjRtjr_v5xjFymw&ved=2ahUKEwjQq7auscyHAxUbGLkGHXcJEQEQ8tMDegQICBAS"
        },
        {
          "page": "10",
          "url": "https://www.google.com/search?q=Joe+biden&sca_esv=07485e11c038ba95&sca_upv=1&gl=US&hl=en&ei=KJ2nZtD3J5uw5OUP95LECA&start=90&sa=N&sstk=Aagrsuj725R4-CJJbh5cksxMJCzTYMp6r1ULVx2RjjdO9KsGFtgw-I1u8CrtR7I24UfuJsm3pSE0-NAmEB892kWjjRtjr_v5xjFymw&ved=2ahUKEwjQq7auscyHAxUbGLkGHXcJEQEQ8tMDegQICBAU"
        },
        {
          "page": "Next",
          "url": "https://www.google.com/search?q=Joe+biden&sca_esv=07485e11c038ba95&sca_upv=1&gl=US&hl=en&ei=KJ2nZtD3J5uw5OUP95LECA&start=10&sa=N&sstk=Aagrsuj725R4-CJJbh5cksxMJCzTYMp6r1ULVx2RjjdO9KsGFtgw-I1u8CrtR7I24UfuJsm3pSE0-NAmEB892kWjjRtjr_v5xjFymw&ved=2ahUKEwjQq7auscyHAxUbGLkGHXcJEQEQ8NMDegQICBAW"
        }
      ]
    },
    "top_section": {
      "featured_snippet": {},
      "products": [],
      "answer_box": {}
    },
    "query": {
      "auto_correction": {},
      "related_search": []
    },
    "local_results": {
      "map": {},
      "places": [],
      "hotels": []
    },
    "ads": {
      "top_text_ads": [],
      "bottom_text_ads": [],
      "product_ads": [],
      "sidebar_product_ads": []
    },
    "search_parameters": {
      "gl": "US",
      "hl": "en"
    }
  }
}
Modified at 2024-07-29 13:12:57
Previous
/location
Built with