google-this

<h1 align="center"> Google This </h1> <p align="center">A simple yet powerful module to retrieve organic search results and much more from Google.<p>  <div align="center">

<br>

</div> <p align="center"> <a href="#installation">Installation</a> - <a href="#usage">Getting Started</a> - <a href="#image-search">Image Search</a> - <a href="#related-projects">Related Projects</a> - <a href="#see-also">See Also</a> </p>

Installation

# NPM
npm install googlethis@latest

# Yarn
yarn add googlethis@latest

# Git 
npm install LuanRT:google-this

Usage

// const google = require('googlethis');
import google from 'googlethis';

const options = {
  page: 0, 
  safe: false, // Safe Search
  parse_ads: false, // If set to true sponsored results will be parsed
  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);

<details> <summary>Output</summary> <p>

{
  "results": [
    {
      "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)",
      "is_sponsored": false,
      "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 game series developed and published by Telltale Games and Skybound Games. It is based on the comic book ...",
      "url": "https://en.m.wikipedia.org/wiki/The_Walking_Dead_(video_game_series)",
      "is_sponsored": false,
      "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)",
      "description": "The Walking Dead, also known as The Walking Dead: A Telltale Games ...",
      "url": "https://walkingdead.fandom.com/wiki/The_Walking_Dead_(Video_Game)",
      "is_sponsored": false,
      "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 on Steam",
      "description": "Apr 24, 2012 — The Walking Dead is a five-part game series set in the ...",
      "url": "https://store.steampowered.com/app/207610/The_Walking_Dead/",
      "is_sponsored": false,
      "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 Telltale Definitive Series on Steam",
      "description": "Oct 29, 2020 — The Walking Dead: The Telltale Definitive Series ...",
      "url": "https://store.steampowered.com/app/1449690/The_Walking_Dead_The_Telltale_Definitive_Series/",
      "is_sponsored": false,
      "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 (Video Game 2012) - IMDb",
      "description": "The Walking Dead: Directed by Sean Ainsworth, Nick Herman, Dennis Lenart, Eric Parsons, Jake Rodkin, Sean Vanaman. With Dave Fennoy, Melissa Hutchison, ...",
      "url": "https://m.imdb.com/title/tt2006890/",
      "is_sponsored": false,
      "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: A New Frontier (Video Game 2016) - IMDb",
      "description": "The Walking Dead: A New Frontier: Directed by Rebekah Gamin, Jason Latino, Chris Rebbert, Jason Pyke. With Jeff Schine, ...",
      "url": "https://m.imdb.com/title/tt5785978/",
      "is_sponsored": false,
      "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 (Telltale) (Video Game) - TV Tropes",
      "description": "The Walking Dead: The Game is an episodic series by Telltale Games that began in 2012. As in Jurassic Park: The Game, you guide your character in an ...",
      "url": "https://tvtropes.org/pmwiki/pmwiki.php/VideoGame/TheWalkingDead",
      "is_sponsored": false,
      "favicons": {
        "high_res": "https://api.faviconkit.com/tvtropes.org/192",
        "low_res": "https://www.google.com/s2/favicons?sz=64&domain_url=tvtropes.org"
      }
    },
    {
      "title": "Assistir | The Walking Dead | Star+ - Star Plus",
      "description": "The Walking Dead. A série acompanha um grupo de sobreviventes durante um apocalipse zumbi. Às vezes, os conflitos interpessoais geram tanto perigo que ...",
      "url": "https://www.starplus.com/pt-br/series/the-walking-dead/6FPLfTcQrTpy",
      "is_sponsored": false,
      "favicons": {
        "high_res": "https://api.faviconkit.com/www.starplus.com/192",
        "low_res": "https://www.google.com/s2/favicons?sz=64&domain_url=www.starplus.com"
      }
    }
  ],
  "videos": [],
  "knowledge_panel": {
    "type": "Video game",
    "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 and a spin-off game based on Michonne.",
    "url": "https://en.m.wikipedia.org/wiki/The_Walking_Dead_(video_game)",
    "metadata": [
      {
        "title": "Series",
        "value": "The Walking Dead"
      },
      {
        "title": "Developer",
        "value": "Telltale Games"
      },
      {
        "title": "Initial release date",
        "value": "2012"
      },
      {
        "title": "Platforms",
        "value": "Android, PlayStation 4, Xbox One, Nintendo Switch, Xbox 360, PlayStation 3, more"
      },
      {
        "title": "Genres",
        "value": "Interactive film, Graphic adventure game, Adventure"
      },
      {
        "title": "Composer",
        "value": "Jared Emerson-Johnson"
      },
      {
        "title": "Developer",
        "value": "Telltale Games"
      }
    ],
    "books": [],
    "tv_shows_and_movies": [],
    "ratings": [
      {
        "name": "Steam",
        "rating": "10/10"
      },
      {
        "name": "IMDb",
        "rating": "9.2/10"
      }
    ],
    "available_on": [],
    "images": [
      {
        "url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSpoOQkbxKJEboeavLycSjFV5OfGEJaOUsEow&s",
        "source": "https://store.steampowered.com/app/261030/The_Walking_Dead_Season_Two/"
      },
      {
        "url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSUtInvx4Jj5kTmXUCpJKiwsFwf8LdgzmFa3A&s",
        "source": "https://walkingdead.fandom.com/pt-br/wiki/The_Walking_Dead_(Videogame)"
      },
      {
        "url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRmMl5yCFIryUsbYN2wt0wCnMVJXMSdjHVriw&s",
        "source": "https://play.google.com/store/apps/details?id=com.telltalegames.walkingdead300&hl=pt&gl=US"
      },
      {
        "url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRuwJA94PfF_7Hvy-9OH3QuOYje1U-B4Cd8bg&s",
        "source": "https://store.steampowered.com/app/261030/The_Walking_Dead_Season_Two/"
      },
      {
        "url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTo4iHcqSh0pXQddH1EpJYfD7g6Qn69fd2M5g&s",
        "source": "https://walkingdead.fandom.com/pt-br/wiki/2%C2%AA_Temporada_(Videogame)"
      },
      {
        "url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRf6xUDRt1VU8nQnx2_mM7tESJ5CemDlf5LBA&s",
        "source": "https://store.steampowered.com/app/536220/The_Walking_Dead_A_New_Frontier/"
      },
      {
        "url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR-tvBUafKU2LtipNbiQsnlzmTiTfwCh3aHcw&s",
        "source": "https://walkingdead.fandom.com/wiki/Season_3_(Video_Game)"
      },
      {
        "url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcS36f_nMhFvGCOOG8L7bdv-oP2hDgjBQsEOuQ&s",
        "source": "https://store.steampowered.com/app/261030/The_Walking_Dead_Season_Two/"
      }
    ],
    "songs": [],
    "demonstration": null,
    "lyrics": null
  },
  "featured_snippet": {
    "title": null,
    "description": null,
    "url": null
  },
  "did_you_mean": null,
  "weather": {
    "location": null,
    "forecast": null,
    "precipitation": null,
    "humidity": null,
    "temperature": null,
    "wind": null
  },
  "time": {
    "hours": null,
    "date": null
  },
  "location": {
    "title": null,
    "distance": null,
    "map": null
  },
  "dictionary": {
    "word": null,
    "phonetic": null,
    "audio": null,
    "definitions": [],
    "examples": []
  },
  "translation": {
    "source_language": null,
    "target_language": null,
    "source_text": null,
    "target_text": null
  },
  "top_stories": [],
  "unit_converter": {},
  "people_also_ask": [
    "the walking dead: the final season",
    "The Walking Dead game Season 4",
    "Twdg characters",
    "The Walking Dead game Season 5",
    "The Walking Dead game download",
    "The Walking Dead Game wiki",
    "The Walking Dead: 400 Days",
    "the walking dead: the telltale definitive series",
    "The Walking Dead: Michonne",
    "The Walking Dead game PC",
    "the walking dead: a new frontier",
    "The Walking Dead Telltale",
    "the walking dead: season two",
    "How long does it take to play TWDG?",
    "What genre is TWDG?",
    "Is there going to be a season 5 of TWDG?",
    "How long is TWDG Season 2?",
    "twdg clementine",
    "the walking dead: the final season",
    "twdg characters",
    "the walking dead game season 4",
    "the walking dead game wiki",
    "the walking dead game season 5",
    "the walking dead: the telltale definitive series",
    "the walking dead game download"
  ],
  "people_also_search": []
}

</p> </details>

What else can it do?

As you can see, the library returns a lot of data. Currently, it can retrieve and parse almost everything you can get from a google search! From knowledge graph and featured snippets to Google Dictionary, Google Translate, song lyrics and more. All you have to do is search something along the lines of “define xyz”, “translate x to y” or “xyz song lyrics” and their respective fields will appear in the response.

Examples:

Knowledge Graph:

Knowledge Graph

Will look like:

{
   //....
  "knowledge_panel": {
    "type": "English theoretical physicist",
    "title": "Stephen Hawking",
    "description": "Stephen William Hawking CH CBE FRS FRSA was an English theoretical physicist, cosmologist, and author who, at the time of his death, was director of research at the Centre for Theoretical Cosmology at the University of Cambridge.",
    "url": "https://en.m.wikipedia.org/wiki/Stephen_Hawking",
    "metadata": [
      {
        "title": "Born",
        "value": "January 8, 1942, Oxford, United Kingdom"
      },
      {
        "title": "Died",
        "value": "March 14, 2018, Cambridge, United Kingdom"
      },
      {
        "title": "Spouse",
        "value": "Jane Hawking (m. 1965–1995)"
      },
      {
        "title": "Children",
        "value": "Lucy Hawking, Robert Hawking, Timothy Hawking"
      },
      {
        "title": "Grandchild",
        "value": "William Smith"
      }
    ],
    "books": [
      {
        "title": "A Brief History of Time",
        "year": "1988"
      },
      {
        "title": "The Theory of Everything",
        "year": "2002"
      },
      {
        "title": "Brief Answers to the Big Questions",
        "year": "2018"
      },
      // ...
    ],
    "tv_shows_and_movies": [
      {
        "title": "The Big Bang Theory",
        "year": "2007 – 2019"
      },
      {
        "title": "Hawking",
        "year":