A module to retrieve organic search results and much more from Google.
- playstore-scraper: a scraper to get search results from Google Play Store.
- lexico-dictionary: a module that scrapes lexico.com to get the definition of words, examples and pronunciation.
npm install googlethisconst google = require("googlethis");
async function start() {
const options = {
page: 0,
safe: false, // hide explicit results?
additional_params: {
// add additional parameters here, see https://moz.com/blog/the-ultimate-guide-to-the-google-search-parameters and https://www.seoquake.com/blog/google-search-param/
hl: 'en'
}
}
const response = await google.search("TWDG", options);
console.log(response);
}
start();Output
{
"results":[
{
"title":"The Walking Dead (Video Game) | Walking Dead Wiki | Fandom",
"description":"The Walking Dead, also known as The Walking Dead: A Telltale Games ...",
"url":"https://walkingdead.fandom.com/wiki/The_Walking_Dead_(Video_Game)",
"favicons":{
"high_res":"https://api.faviconkit.com/walkingdead.fandom.com/192",
"low_res":"https://www.google.com/s2/favicons?sz=64&domain_url=walkingdead.fandom.com"
}
},
{
"title":"The Walking Dead (video game) - Wikipedia",
"description":"The Walking Dead is an episodic adventure video game developed and ...",
"url":"https://en.m.wikipedia.org/wiki/The_Walking_Dead_(video_game)",
"favicons":{
"high_res":"https://api.faviconkit.com/en.m.wikipedia.org/192",
"low_res":"https://www.google.com/s2/favicons?sz=64&domain_url=en.m.wikipedia.org"
}
},
{
"title":"The Walking Dead (video game series) - Wikipedia",
"description":"The Walking Dead is an episodic, graphic adventure video game series developed and published by Telltale Games and Skybound Games, based on The Walking Dead ...",
"url":"https://en.m.wikipedia.org/wiki/The_Walking_Dead_(video_game_series)",
"favicons":{
"high_res":"https://api.faviconkit.com/en.m.wikipedia.org/192",
"low_res":"https://www.google.com/s2/favicons?sz=64&domain_url=en.m.wikipedia.org"
}
},
{
"title":"The Walking Dead: The Final Season (Video Game 2018) - IMDb",
"description":"The Walking Dead: The Final Season: Directed by Vahram Antonian, Mark Darin, Chris Rebbert, Kent Mudle. With Melissa ...",
"url":"https://m.imdb.com/title/tt7211930/",
"favicons":{
"high_res":"https://api.faviconkit.com/m.imdb.com/192",
"low_res":"https://www.google.com/s2/favicons?sz=64&domain_url=m.imdb.com"
}
},
{
"title":"The Walking Dead on Steam",
"description":"Apr. 24, 2012 — About This Game ... The Walking Dead is a five-part game series set in the same universe as Robert Kirkman' ...",
"url":"https://store.steampowered.com/app/207610/The_Walking_Dead/",
"favicons":{
"high_res":"https://api.faviconkit.com/store.steampowered.com/192",
"low_res":"https://www.google.com/s2/favicons?sz=64&domain_url=store.steampowered.com"
}
},
{
"title":"The Walking Dead: The Final Season on Steam",
"description":"All this creates the most engaging The Walking Dead game yet. Striking New Visual Style - The all-new Graphic Black art style ...",
"url":"https://store.steampowered.com/app/866800/The_Walking_Dead_The_Final_Season/",
"favicons":{
"high_res":"https://api.faviconkit.com/store.steampowered.com/192",
"low_res":"https://www.google.com/s2/favicons?sz=64&domain_url=store.steampowered.com"
}
},
{
"title":"The Walking Dead (@TWDGameNews) | Twitter",
"description":"The latest Tweets from The Walking Dead (@TWDGameNews). Your best online source about The Walking Dead & The Wolf Among Us game.",
"url":"https://twitter.com/twdgamenews?lang=en",
"favicons":{
"high_res":"https://api.faviconkit.com/twitter.com/192",
"low_res":"https://www.google.com/s2/favicons?sz=64&domain_url=twitter.com"
}
},
{
"title":"The Walking Dead (TWD) - Games - Skybound Entertainment",
"description":"Get The Latest News on The Walking Dead (TWD) Games! TWD Video & Board Games from Skybound.",
"url":"https://www.skybound.com/the-walking-dead/games",
"favicons":{
"high_res":"https://api.faviconkit.com/www.skybound.com/192",
"low_res":"https://www.google.com/s2/favicons?sz=64&domain_url=www.skybound.com"
}
}
],
"knowledge_panel":{
"title":"The Walking Dead",
"description":"The Walking Dead is an episodic adventure video game developed and published by Telltale Games. It is the first game in the series, which consists of 4 seasons. Based on The Walking Dead comic book series, the game consists of five episodes, released between April and November 2012. Wikipedia",
"url":"https://en.m.wikipedia.org/wiki/The_Walking_Dead_(video_game)",
"initial_release_date":"2012",
"series":"The Walking Dead",
"developer":"Telltale Games",
"composer":"Jared Emerson-Johnson",
"platforms":"Android, PlayStation 4, Xbox One, PlayStation 3, Xbox 360, Nintendo Switch, iOS, more",
"awards":"VGX Award for Game of the Year, BAFTA Games Award for Story, more",
"type":"Video game",
"ratings":[
{
"name":"Steam",
"rating":"10/10"
}
],
"images":[
"https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRnUQa_EmZ0pnMkStzGkFYkCWqqkXTRhL7kEg&s",
"https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRVKcTnZC-Y9HW_E37tgu6vTEZSM4lb0F_DHw&s",
"https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSPvrFr-3o2yTiA8DUXgo-53uvBN07NionfQg&s",
"https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSITB1paL8GBaYHyw5HlPU60pFdnGV09ygGsw&s",
"https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQIBbIaCsOB7j-WFYSdjsmTem99Px0UpsrH8A&s",
"https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSwOyoVlvDXYBh_pe8BbJHLSuzq76VGwRUWjw&s",
"https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSeentvUA6NaUU2lt8U-kKS6vbijZA9H7a8qw&s",
"https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTNTRozFnQgRKDsC5aaXj31HvLkcKvroHqExA&s"
]
},
"featured_snippet":{
"title":"N/A",
"description":"N/A",
"url":"N/A"
},
"people_also_ask":[
"How old is Clementine now?",
"Is Telltale Games coming back?",
"Which Walking Dead game is the first?",
"Who does Clementine kill?",
"The Walking Dead: The Final Season",
"The Walking Dead: a new frontier",
"The Walking Dead game characters",
"The Walking Dead game Season 1"
],
"people_also_search_for":[
{
"title":"No Time Left",
"thumbnail":"https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR_wtNr_d0gBzbe7dg0YoVSdvdB7rgweocVYJy5DVnR6ov7V6c8L0BI&s=0"
},
{
"title":"Game of Thrones",
"thumbnail":"https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQKzG_TUO0Tod17lRMWU7KL2dkwM94vJuNqLftaTiBtTe0S0FodzNVf&s=0"
},
{
"title":"Guardians of the Gal...",
"thumbnail":"https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR5xJSPBCbODhI0dWbeY4kzGkfskqvQnHzuQX3_&s=0"
},
{
"title":"Back to the Future: Th...",
"thumbnail":"https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQWO4NW3GB4TOTAIr19tT9ank02h9lpKEABr4ZZ52F4cB3VcOYdOtvt&s=0"
},
{
"title":"Her Story",
"thumbnail":"https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSJeKXjj9Nwr0-sJpL5a6YrY2t7P1vTyNOl3saBNIOTsPDxrp0xQM9ndw&s=0"
},
{
"title":"Until Dawn",
"thumbnail":"https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQk_V2rpYv-uxX9iBQRvesqslm0RQyPiCvXJH2mqrKYId5frNk_KGOo&s=0"
},
{
"title":"Metal Gear Solid 4: G...",
"thumbnail":"https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQCjlTxFMIicoB6cf1-jU7NQ_t-VmYUC5odE2xO-zwVqXKOpJ51csVS&s=0"
},
{
"title":"Night Trap",
"thumbnail":"https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRBJZxuw2oVSK1DUChLRyelrVeQ2z79A7zqVx41pk63_b2e2b_4G0fF&s=0"
}
]
}As you may have noticed google-this returns a lot of data. Currently it can parse everything in the knowledge graph, featured snippets and much more. It can also parse Google Dictionary, Google Translator and song lyrics.
All you have to do is search something like “define xyz” or “translate x to y” or “xyz song lyrics” and the appropriated fields will appear in the response.
Knowledge Graph:
Will look like:
{
//....
"knowledge_panel":{
"title":"Stephen Hawking",
"description":"Stephen William Hawking CH CBE FRS FRSA was an English theoretical physicist, cosmologist, and author who was director of research at the Centre for Theoretical Cosmology at the University of Cambridge at the time of his death. Wikipedia",
"url":"https://en.m.wikipedia.org/wiki/Stephen_Hawking",
"born":"January 8, 1942, Oxford, United Kingdom",
"died":"March 14, 2018, Cambridge, United Kingdom",
"spouse":"Elaine Mason (m. 1995–2006), Jane Hawking (m. 1965–1995)",
"movies_and_tv_shows":"Hawking, A Brief History of TIme, Into the Universe With Stephen Hawking, More",
"children":"Timothy Hawking, Lucy Hawking, Robert Hawking",
"type":"English theoretical physicist",
"images":[
"https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSbo1y6C46Dna993Bw7iIztiiZOj5WfA54SpQ&s",
"https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRhXQYMTZibjbSZtBUW1Df0Gfj_hC2yUe-VXg&s",
"https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTBobu5FJNK-ODDQ460gl3hXkCbG8tra6lrwA&s",
"https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSpiLDQRs5ooaW-YS-n_Nx3tcO2iZZdbPlMfg&s",
"https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcS5TlacgKOWalH1VyyS2eYCXrANh8uIB3odGw&s",
"https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSEVmJ4x1DnAIzJhct6guTBwwbSgs5m1O-Twg&s",
"https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTtvaqvu6ndURMzPSYX9ZnTWVnnsKBmZybARQ&s",
"https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTNu12K_vNhnXcjhp6rrnmDo_S-f7IocPjUeg&s"
]
}
}Google Translator:
Will be:
{
//...
"translation": {
"source_language":"English - detected",
"target_language":"German",
"source_text":"this is a test",
"target_text":"das ist ein Test"
}
}Google Dictionary:
↓↓↓
{
//...
"dictionary":{
"word":"a·maz·ing",
"phonetic":"/əˈmāziNG/",
"audio":"https://ssl.gstatic.com/dictionary/static/sounds/20200429/amazing--_us_1.mp3",
"definitions":[
"causing great surprise or wonder; astonishing.",
"startlingly impressive."
],
"examples":[
"\"an amazing number of people registered\"",
"\"she makes the most amazing cakes\""
]
}
}Pretty amazing, isn't it? :D
For more info check out the examples file.
If that's not enough google-this has the ability to search for images and do reverse image search!
Check it out:
const google = require("googlethis");
async function start() {
// Image Search
const images = await google.image("The Wolf Among Us", { safe: false });
console.log(images);
// Reverse Image Search
const reverse = await google.search("https://i.pinimg.com/236x/92/16/d9/9216d9a222ef65eb6eabfff1970180d1.jpg", { ris: true });
console.log(reverse.results);
}
start();Image Search output
[
{
"url":"https://steamcdn-a.akamaihd.net/steam/apps/250320/capsule_616x353.jpg?t\\u003d1593722673",
"width":"353",
"height":"616",
"origin":{
"title":"The Wolf Among Us on Steam",
"website":"https://store.steampowered.com/app/250320/The_Wolf_Among_Us/"
}
},
{
"url":"https://store-images.s-microsoft.com/image/apps.5089.13510798887517413.56778ce8-0de1-44ba-89b1-769ebb2fa5e1.fd83647a-219d-49e2-bc3c-105b1f33be77",
"width":"1080",
"height":"720",
"origin":{
"title":"Buy The Wolf Among Us - A Telltale Games Series - Microsoft Store en-IN",
"website":"https://www.microsoft.com/en-in/p/the-wolf-among-us-a-telltale-games-series/9nblggh4w0td"
}
},
{
"url":"https://cdn.vox-cdn.com/thumbor/Zp1L6Vji2NEk0sxmeYmbThbq4CY\\u003d/0x0:1280x720/1200x800/filters:focal(538x258:742x462)/cdn.vox-cdn.com/uploads/chorus_image/image/65898028/69262385_408272906381786_5376154085030363136_n.0.png",
"width":"800",
"height":"1200",
"origin":{
"title":"The Wolf Among Us 2 back in development at Telltale - Polygon",
"website":"https://www.polygon.com/game-awards-tga/2019/12/12/21011644/the-wolf-among-us-2-telltale-windows-trailer-tga-2019"
}
},
{
"url":"https://media.telltale.com/content/2019/08/15202452/twau_screenshot_1.jpg",
"width":"562",
"height":"1000",
"origin":{
"title":"The Wolf Among Us – Telltale Games",
"website":"https://www.telltale.com/the-wolf-among-us/"
}
},
{
"url":"https://cdn.vox-cdn.com/thumbor/zF-gSuNaZbRvSyxuIOjQw2rRag0\\u003d/155x0:1842x1125/2050x1367/cdn.vox-cdn.com/uploads/chorus_image/image/36052600/fight-bigby_2000px.0.jpg",
"width":"1367",
"height":"2050",
"origin":{
"title":"The Wolf Among Us' season one review: a terrifying fairy tale | The Verge",
"website":"https://www.theverge.com/2014/7/25/5931015/the-wolf-among-us-season-one-review"
}
},
{
"url":"https://images-na.ssl-images-amazon.com/images/I/91GP8qHLRvL.jpg",
"width":"2560",
"height":"1659",
"origin":{
"title":"Fables: The Wolf Among Us Vol. 2: Sturges, Matthew, Nguyen, Eric: 9781401261375: Amazon.com: Books",
"website":"https://www.amazon.com/Fables-Wolf-Among-Us-Vol/dp/140126137X"
}
},
{
"url":"https://d2skuhm0vrry40.cloudfront.net/2019/articles/2019-12-13-04-26/-1576211173089.jpg/EG11/resize/1200x-1/-1576211173089.jpg",
"width":"673",
"height":"1200",
"origin":{
"title":"Telltale's The Wolf Among Us 2 just got re-announced • Eurogamer.net",
"website":"https://www.eurogamer.net/articles/2019-12-13-telltales-the-wolf-among-us-2-just-got-re-announced"
}
},
{
"url":"https://cdn.vox-cdn.com/thumbor/-VoSq1f8QmFu5VR0f7lh6z3IQGM\\u003d/0x0:1920x1080/1200x800/filters:focal(807x387:1113x693)/cdn.vox-cdn.com/uploads/chorus_image/image/68492490/ss_be6d5010313dae1668d150f1da64802be0a37a06.0.jpg",
"width":"800",
"height":"1200",
"origin":{
"title":"Telltale Games updates fans on The Wolf Among Us 2 and more - Polygon",
"website":"https://www.polygon.com/2020/12/10/22168137/telltale-games-december-2020-update-wolf-among-us-2-development"
}
},
{
"url":"https://bloody-disgusting.com/wp-content/uploads/2019/12/wolfamongus.jpg",
"width":"535",
"height":"830",
"origin":{
"title":"Development on 'The Wolf Among Us 2' Starting From Scratch With New Technology, Says LCG Entertainment - Bloody Disgusting",
"website":"https://bloody-disgusting.com/video-games/3598711/development-wolf-among-us-2-starting-scratch-new-technology-says-lcg-entertainment/"
}
},
{
"url":"https://m.media-amazon.com/images/I/71a8K4ndPqL._SL1111_.jpg",
"width":"1111",
"height":"894",
"origin":{
"title":"Amazon.com: The Wolf Among Us - Xbox One: Ui Entertainment: Video Games",
"website":"https://www.amazon.com/Wolf-Among-Us-Xbox-One/dp/B00K2O54W8"
}
},
{
"url":"https://www.nerdmuch.com/wp-content/uploads/2020/08/the-wolf-among-us-season-2.jpg",
"width":"720",
"height":"1280",
"origin":{
"title":"The Wolf Among Us: 5 Questions We Need Answered for Season 2",
"website":"https://www.nerdmuch.com/the-wolf-among-us-questions-season-2/"
}
},
{
"url":"https://cdn.gamer-network.net/2017/articles/2017-07-19-17-08/telltale-announces-the-wolf-among-us-season-two-days-after-telling-fans-not-to-get-hopes-up-1500480538390.jpg/EG11/thumbnail/1920x1275/format/jpg/quality/80",
"width":"1275",
"height":"1920",
"origin":{
"title":"Telltale announces The Wolf Among Us season two, days after telling fans not to get hopes up • Eurogamer.net",
"website":"https://www.eurogamer.net/articles/2017-07-19-telltale-announces-the-wolf-among-us-season-two-days-after-telling-fans-not-to-get-hopes-up"
}
},
{
"url":"https://images-na.ssl-images-amazon.com/images/I/91LxQ01hcLL.jpg",
"width":"2560",
"height":"1642",
"origin":{
"title":"Fables: The Wolf Among Us Vol. 1: Sturges, Matthew, Justus, Dave, McManus, Shawn: 9781401256845: Amazon.com: Books",
"website":"https://www.amazon.com/Fables-Wolf-Among-Us-Vol/dp/1401256848"
}
},
{
"url":"https://cdn.vox-cdn.com/thumbor/AMBox6ZhB1r3KtOscpicO9lD4Ww\\u003d/85x0:1014x619/2050x1367/cdn.vox-cdn.com/assets/3367723/BigbyCigaretteFable.jpg",
"width":"1367",
"height":"2050",
"origin":{
"title":"Can the developers of 'The Walking Dead' make a great crime drama? | The Verge",
"website":"https://www.theverge.com/2013/10/11/4825254/the-wolf-among-us-episode-one-review"
}
},
{
"url":"https://gearnuke.com/wp-content/uploads/2018/07/the-wolf-among-us-season-2-demo-images-1.jpg",
"width":"1080",
"height":"1920",
"origin":{
"title":"The Wolf Among Us Season 2 Early Screenshots Leaked (Update)",
"website":"https://gearnuke.com/the-wolf-among-us-season-2-early-tech-demo-screenshots/"
}
}
]Reverse Image Search output
[
{
"title":"Guess I'll Just Die | Meme Generator",
"description":"401 × 401 · Oct 1, 2016 — Create your own images with the Guess I'll Just Die meme generator.",
"url":"https://memegenerator.net/Guess-ILl-Just-Die"
},
{
"title":"I Guess I Ll Just Die - Love Meme",
"description":"401 × 401 · Apr 23, 2020 — 4 6k points 1 year ago. Upload your own image. Guess i ll die meme generator the fastest meme generator on the planet. A stock photo of a white ...",
"url":"https://lovememepic.blogspot.com/2020/04/i-guess-i-ll-just-die.html"
},
{
"title":"šarvátka pistole zarovnání ddlc guess i'll die Barma vědět bit",
"description":"553 × 457 — šarvátka pistole zarovnání ddlc guess i'll die Barma vědět bit. ... Yandere-DDLC-RP blaze the blaziken Memes & GIFs - Imgflip ...",
"url":"https://www.theweddingtraveler.com/ddlc-guess-i%27ll-die-k.html"
},
{
"title":"Guess I'll Just Die - Caption | Meme Generator",
"description":"401 × 401 — Bypass this CAPTCHA with a Meme Generator Premium account. Generate! Guess I'll Just Die.",
"url":"https://memegenerator.net/Guess-ILl-Just-Die/caption"
},
{
"title":"had a coughing fit - Guess Ill die | Meme Generator",
"description":"401 × 401 — Guess Ill die. 0. comments. Comment. Report image. Note: Only personal attacks are removed, otherwise if it's just content you find offensive, ...",
"url":"https://memegenerator.net/instance/71709681/guess-ill-die-had-a-coughing-fit"
}
]Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Please make sure to update tests as appropriate.