The Google Search Results API allows you to retrieve live google search results.
Each API call will cost 1 search credit. You are only charged for successful
searches.
💡
Leverage the free Playground to test your Google searches.
Location the search will be performed from. When defined, the system will attempt to use a proxy in the same region. Use the Locations API to get a valid list of canonical locations that can be used for your Google Search.
uule
Pass a custom uule parameter.
Localization Parameters
Parameter
Description
google_domain
Google domain to perform the search on. Defaults to google.com
gl
The country code to perform the search.
hl
The language of the Google search results page.
cr
The cr parameter limits the results to the specified country.
lr
The lr parameter limits the results to the specified language.
Content Filtering Parameters
Parameter
Description
tbs
Passthrough tbs parameter to Google search
safe
Set to true to enable Google safe search.
nfpr
Set to true to exclude results that are auto-corrected from the search string
filter
Set to false to exclude similar results.
Pagination
Parameter
Description
start
Results offset
num
Number of results to return
Response
The following represents a sample response, constructed to show each possible
section that is supported.
{ "organic": [ { "position": 1, "title": "Apple", "url": "https://www.apple.com/", "redirect_url": "/url?sa=t&source=web&rct=j&opi=89978449&url=https://www.apple.com/&ved=2ahUKEwjfxs6oyYiEAxUIJjQIHSyxAkMQFnoECBYQAQ", "displayed_url": "https://www.apple.comhttps://www.apple.com", "snippet": { "content": "Discover the innovative world of Apple and shop everything iPhone, iPad, Apple Watch, Mac, and Apple TV, plus explore accessories, entertainment, ...", "highlighted_words": [ "Apple", "Apple", "Apple" ], "sitelinks": [ { "title": "Mac", "url": "https://www.apple.com/mac/", "snippet": "The most powerful Mac laptops and desktops ever ..." }, { "title": "Store", "url": "https://www.apple.com/store", "snippet": "Shop iPhone - Shop Mac - Shop iPad - Shop Apple Watch - ..." }, { "title": "iPhone", "url": "https://www.apple.com/iphone/", "snippet": "Powerful. Beautiful. Durable. Check out the new iPhone 15 ..." }, { "title": "Watch", "url": "https://www.apple.com/watch/", "snippet": "Apple Watch is the ultimate device for a healthy life. Available in ..." } ] } } ], "ads": [ { "position": 1, "title": "Apple - Official Site", "url": "https://www.apple.com/store", "tracking_url": "https://www.google.com/aclk?sa=l&ai=DChcSEwiu1teoyYiEAxV6EK0GHU09CCkYABAAGgJwdg&ase=2&gclid=EAIaIQobChMIrtbXqMmIhAMVehCtBh1NPQgpEAAYASAAEgJrEPD_BwE&sig=AOD64_22bGOiJ6oNJUOVYReOMj1mQQA1HQ&q&nis=4&adurl", "snippet": { "content": "Apple Vision Pro. Welcome to the era of spatial computing. Pre-order now. Shoot magical spatial videos with iPhone 15 Pro, then relive them on Apple Vision Pro. Free shipping or pickup. Apple Trade In. Chat for shopping help. Payment options available.", "highlighted_words": [ "Apple", "Apple", "Apple" ], "sitelinks": [ { "title": "iPhone 15", "url": "https://www.apple.com/us/shop/go/iphone_15?", "snippet": "Trade in iPhone 11 or higher to get $180-$620 off iPhone 15. See terms." }, { "title": "Mac", "url": "https://www.apple.com/us/shop/go/mac?", "snippet": "Shop MacBook Pro, MacBook Air, iMac, Mac mini, Mac Studio & more." }, { "title": "Apple Watch", "url": "https://www.apple.com/us/shop/go/watch/?", "snippet": "Shop Apple Watch Series 9, Apple Watch Ultra 2, and Apple Watch SE." }, { "title": "Apple Vision Pro", "url": "https://www.apple.com/us/shop/go/apple_vision_pro/?", "snippet": "The ultimate theater. Wherever you are. Pre-order now." } ] } } ], "products": [ { "position": 1, "title": "Apple iPhone 13", "price": "$299.99 now", "source": "T-Mobile, 5+ stores", "rich_results": [ "Free delivery" ] } ], "stories": [ { "position": 1, "title": "The Apple Vision Pro Is a Marvel. But Who Will Buy It?", "url": "https://www.nytimes.com/2024/01/31/technology/roose-apple-vision-pro.html", "source": "The New York Times", "date": "4 hours ago" } ], "shopping": [ { "position": 1, "title": "Samsung - Galaxy S24 Ultra 512GB in Titanium Black (Unlocked)(SM-S928UZKFXAA)Samsung - Galaxy S24 Ultra 512GB in Titanium Black (Unlocked)(SM-S928UZKFXAA)", "url": "https://www.samsung.com/us/smartphones/galaxy-s24-ultra/buy/galaxy-s24-ultra-512gb-unlocked-sm-s928uzkfxaa/", "price": "$1,419.99", "source": "SamsungSamsung", "rich_results": [ "$1,419.99", "SamsungSamsung", "(73) total reviews", "Rated 4.6 out of 5," ] } ], "videos": [ { "position": 1, "title": "$1 vs $250,000,000 Private Island!", "url": "https://www.youtube.com/watch?v=krsBRQbOPQ4&vl=en", "channel": "MrBeast", "platform": "YouTube", "duration": "16 minutes, 59 seconds", "date": "4 days ago" } ]}