Query keywords that a user wants to search for e.g. sports car
COUNTRY_CODE
Where a google domain needs to be scraped from another country (e.g. scraping google.com from Canada to get Canadian results), specify the TLD as well as the COUNTRY_CODE parameters. Valid values are valid TLDs (e.g. β.com.auβ, β.esβ, etc.).
TLD
Country of Google domain to scrape. This is an optional argument and defaults to βusβ (google.com). Valid values include:
us: 'google.com',
uk: 'google.co.uk',
ca: 'google.ca',
de: 'google.de',
es: 'google.es',
fr: 'google.fr',
it: 'google.it',
jp: 'google.co.jp',
in: 'google.in',
cn: 'google.cn',
sg: 'google.com.sg',
mx: 'google.com.mx',
ae: 'google.ae',
br: 'google.com.br',
nl: 'google.nl',
au: 'google.com.au',
tr: 'google.com.tr',
sa: 'google.sa',
se: 'google.se',
pl: 'google.pl'
OUTPUT_FORMAT
For structured data methods we offer CSV and JSON output. JSON is default if parameter is not added. Options:
csv
json
Google parameters supported by this endpoint
Google Parameters
Details
UULE
Set a region for a search. For example: w+CAIQICINUGFyaXMsIEZyYW5jZQ. You can find an online UULE generator here.
NUM
Number of results
HL
Host Language. For example: DE
GL
Boosts matches whose country of origin matches the parameter value. For example: DE
IE
Character encoding how the engine interpret the query string. For example: UTF8
OE
Character encoding used for the results. For example: UTF8
START
Set the starting offset in the result list. When start=10 set the first element in the result list will be the 10th search result. (meaning it starts with page 2 of results if the "num" is 10)
Sample Response
{"search_information": {"query_displayed":"earth diameter","total_results":2,"time_taken_displayed":1890000 },"organic_results": [ {"position":0,"title":"What is the Diameter of Earth?","tags":"Jun 14, 2008 β", "snippet": "Jun 14, 2008 β As a result, the latest measurements indicate that the Earth has an equatorial diameter of 12,756 km (7926 mi), and a polar diameter of 12713.6Β ...",
"highlighs": ["equatorial diameter of 12,756 km (7926 mi" ],"link":"https://www.universetoday.com/15055/diameter-of-earth/","displayed_link":"https://www.universetoday.com βΊ diameter-of-earth" }, {"position":1,"title":"What is the diameter of Earth? Teaching Wiki", "snippet": "This gives us a mean diameter of 12,742 km or 7917.5 miles. How was the diameter of Earth first measured? The diameter of Earth was first calculated byΒ ...",
"highlighs": ["12,742 km or 7917.5 miles" ],"link":"https://www.twinkl.com/teaching-wiki/diameter-of-earth","displayed_link":"https://www.twinkl.com βΊ teaching-wiki βΊ diameter-of..." }, {"position":2,"title":"Earth radius", "snippet": "Earth's diameter is simply twice Earth's radius; for example, equatorial diameter (2a) and polar diameter (2b). For the WGS84 ellipsoid, that's respectivelyΒ ...Earth dimensionsEdit ; Equatorial diameter, 12,756.3 km (7,926.4 mi) ; Polar diameter, 12,714 km (7,900 mi) ; Polar radius, 6,356.89 km (3,949.99 mi) ; Volume ofΒ ...",
"highlighs": ["diameter is simply twice Earth's radius","12,756.3 km (7,926.4 mi" ],"link":"https://en.wikipedia.org/wiki/Earth_radius", "displayed_link": "https://en.wikipedia.org βΊ wiki βΊ Earth_radiushttps://en.wikipedia.org βΊ wiki βΊ Earth_physical_chara...",
"sitelinks": {"inline": [ {"title":"Earth physical characteristics tableshttps://en.wikipedia.org βΊ wiki βΊ Earth_physical_chara...","link":"https://en.wikipedia.org/wiki/Earth_physical_characteristics_tables" } ] } }, {"position":3,"title":"How did mankind first determine the size of the Earth?", "snippet": "The circumference of the Earth is just its average diameter, 7915 miles, times the number pi, where pi is 3.14159. This gives us about 25,000 miles for theΒ ...",
"highlighs": ["7915 miles" ],"link":"https://www.uu.edu/dept/physics/scienceguys/2001July.cfm","displayed_link":"https://www.uu.edu βΊ dept βΊ physics βΊ scienceguys" }, {"position":4,"title":"How was the size of Earth first measured?", "snippet": "Earth's circumference was first accurately measured more than 2000 years ago by the Greek astronomer Eratosthenes, who at the time lived in the EgyptianΒ ...",
"highlighs": ["circumference was first accurately measured more than 2000 years ago by" ],"link":"https://stardate.org/astro-guide/faqs/how-was-size-earth-first-measured","displayed_link":"https://stardate.org βΊ astro-guide βΊ faqs βΊ how-was-size..." }, {"position":5,"title":"Essential Facts You Need to Know About Planet Earth","tags":"Jan 15, 2019 β", "snippet": "Jan 15, 2019 β The Earth's diameter at the equator is 7,926.28 miles, and its diameter at the poles is 7,899.80 miles. Rotation on Axis. It takes the Earth 23Β ...",
"highlighs": ["at the equator is 7,926.28 miles" ],"link":"https://www.thoughtco.com/essential-facts-about-the-planet-earth-1435092","displayed_link":"https://www.thoughtco.com βΊ Geography βΊ Basics" }, {"position":6,"title":"Measuring Earth's diameter β ASI POEC", "snippet": "Measuring Earth's diameter. The aim of this activity is to get amateur astronomers, teachers and students to estimate the circumference of the Earth usingΒ ...",
"highlighs": ["Earth's diameter","Earth" ],"link":"https://astron-soc.in/outreach/activities/archaeo-astronomy-projects/measuring-earths-diameter/","displayed_link":"https://astron-soc.in βΊ archaeo-astronomy-projects βΊ m..." }, {"position":7,"title":"Equator","tags":"Dec 1, 2022 β", "snippet": "Dec 1, 2022 β The distance around Earth at the Equator, its circumference, is 40,075 kilometers (24,901 miles). Earth's diameter is also wider at the Equator,Β ...",
"highlighs": ["Earth","Earth's diameter" ],"link":"https://www.nationalgeographic.org/encyclopedia/equator/","displayed_link":"https://www.nationalgeographic.org βΊ encyclopedia" } ],"related_searches": [ {"position":8,"query":"earth circumference", "link": "https://www.google.us/search?q=Earth+circumference&sa=X&ved=2ahUKEwjLleGnm_X9AhUDUaQEHdDsBoI4AxDVAnoECCwQAQ"
}, {"position":9,"query":"earth diameter km","link":"https://www.google.us/search?q=Earth+diameter+km&sa=X&ved=2ahUKEwjLleGnm_X9AhUDUaQEHdDsBoI4AxDVAnoECCoQAQ" }, {"position":10,"query":"earth diameter miles", "link": "https://www.google.us/search?q=Earth+diameter+miles&sa=X&ved=2ahUKEwjLleGnm_X9AhUDUaQEHdDsBoI4AxDVAnoECCkQAQ"
}, {"position":11,"query":"diameter of earth in m", "link": "https://www.google.us/search?q=Diameter+of+Earth+in+M&sa=X&ved=2ahUKEwjLleGnm_X9AhUDUaQEHdDsBoI4AxDVAnoECCYQAQ"
}, {"position":12,"query":"circumference of earth in m", "link": "https://www.google.us/search?q=Circumference+of+Earth+in+M&sa=X&ved=2ahUKEwjLleGnm_X9AhUDUaQEHdDsBoI4AxDVAnoECCUQAQ"
}, {"position":13,"query":"how big is the earth", "link": "https://www.google.us/search?q=How+big+is+the+Earth&sa=X&ved=2ahUKEwjLleGnm_X9AhUDUaQEHdDsBoI4AxDVAnoECCQQAQ"
}, {"position":14,"query":"diameter of earth in feet", "link": "https://www.google.us/search?q=Diameter+of+Earth+in+feet&sa=X&ved=2ahUKEwjLleGnm_X9AhUDUaQEHdDsBoI4AxDVAnoECCMQAQ"
}, {"position":15,"query":"earth diameter at equator", "link": "https://www.google.us/search?q=Earth+diameter+at+equator&sa=X&ved=2ahUKEwjLleGnm_X9AhUDUaQEHdDsBoI4AxDVAnoECC0QAQ"
} ],"pagination": {"pages_count":10,"current_page":2, "next_page_url": "https://www.google.us/search?q=earth+diameter&ei=Re4dZIvfD4OikdUP0NmbkAg&start=20&sa=N&ved=2ahUKEwjLleGnm_X9AhUDUaQEHdDsBoI4AxDy0wN6BAgDEAc",
"prev_page_url": "https://www.google.us/search?q=earth+diameter&ei=Re4dZIvfD4OikdUP0NmbkAg&start=0&sa=N&ved=2ahUKEwjLleGnm_X9AhUDUaQEHdDsBoI4AxDy0wN6BAgDEAQ",
"pages": [ {"page":1, "url": "https://www.google.us/search?q=earth+diameter&ei=Re4dZIvfD4OikdUP0NmbkAg&start=0&sa=N&ved=2ahUKEwjLleGnm_X9AhUDUaQEHdDsBoI4AxDy0wN6BAgDEAQ"
}, {"page":3, "url": "https://www.google.us/search?q=earth+diameter&ei=Re4dZIvfD4OikdUP0NmbkAg&start=20&sa=N&ved=2ahUKEwjLleGnm_X9AhUDUaQEHdDsBoI4AxDy0wN6BAgDEAc"
}, {"page":4, "url": "https://www.google.us/search?q=earth+diameter&ei=Re4dZIvfD4OikdUP0NmbkAg&start=30&sa=N&ved=2ahUKEwjLleGnm_X9AhUDUaQEHdDsBoI4AxDy0wN6BAgDEAk"
}, {"page":5, "url": "https://www.google.us/search?q=earth+diameter&ei=Re4dZIvfD4OikdUP0NmbkAg&start=40&sa=N&ved=2ahUKEwjLleGnm_X9AhUDUaQEHdDsBoI4AxDy0wN6BAgDEAs"
}, {"page":6, "url": "https://www.google.us/search?q=earth+diameter&ei=Re4dZIvfD4OikdUP0NmbkAg&start=50&sa=N&ved=2ahUKEwjLleGnm_X9AhUDUaQEHdDsBoI4AxDy0wN6BAgDEA0"
}, {"page":7, "url": "https://www.google.us/search?q=earth+diameter&ei=Re4dZIvfD4OikdUP0NmbkAg&start=60&sa=N&ved=2ahUKEwjLleGnm_X9AhUDUaQEHdDsBoI4AxDy0wN6BAgDEA8"
}, {"page":8, "url": "https://www.google.us/search?q=earth+diameter&ei=Re4dZIvfD4OikdUP0NmbkAg&start=70&sa=N&ved=2ahUKEwjLleGnm_X9AhUDUaQEHdDsBoI4AxDy0wN6BAgDEBE"
}, {"page":9, "url": "https://www.google.us/search?q=earth+diameter&ei=Re4dZIvfD4OikdUP0NmbkAg&start=80&sa=N&ved=2ahUKEwjLleGnm_X9AhUDUaQEHdDsBoI4AxDy0wN6BAgDEBM"
}, {"page":10, "url": "https://www.google.us/search?q=earth+diameter&ei=Re4dZIvfD4OikdUP0NmbkAg&start=90&sa=N&ved=2ahUKEwjLleGnm_X9AhUDUaQEHdDsBoI4AxDy0wN6BAgDEBU"
} ] }}