0.1.1 • Public • Published


Code-Style:Standard License:MIT

google-kgsearch is a wrapper for Google's Knowledge Graph Search API. It is lightweight, simple, and easy to understand.

About Google's Knowledge Graph Search API:

The Knowledge Graph Search API lets you find entities in the Google Knowledge Graph. The API uses standard types and is compliant with the JSON-LD specification.

An excerpt from:

Use cases

Some examples of how you can use the Knowledge Graph Search API include:

  • Getting relevant information about a specific entity when doing Natural Language Processing
  • Getting a ranked list of the most notable entities that match certain criteria.
  • Predictively completing entities in a search box.
  • Annotating/organizing content using the Knowledge Graph entities.

Quick Example: Search for a Person

Create a KGSearch instance with your API Key, store it in a variable (in this case: kGraph), and then call, callback)

import KGSearch from 'google-kgsearch'
const kGraph = KGSearch(process.env.KGSEARCH_API_KEY)
let params = {
  query: 'Taylor Swift',
  types: 'Person',
  limit: 1
}, (err, items) => {
  if (err) console.error(err)

Outputs an object:

    '@type': 'EntitySearchResult',
    result: {
      '@id': 'kg:/m/0dl567',
      name: 'Taylor Swift',
      '@type': [object],
      description: 'Singer-songwriter',
      image: [object],
      detailedDescription: [object],
      url: ''
    resultScore: 280.279816

See the example for more information.


Installing google-kgsearch is as simple as installing any other npm module:

$ npm install google-kgsearch --save


To use this API you need an API key. An API key identifies your project to check quotas and access. Go to the Credentials page to get an API key.

Check out Google Developers' guide for more information.



After importing the google-kgsearch file, you need to initialize a new KGSearch instance with your API_TOKEN and store it in a variable (in this case its kGraph):

import KGSearch from 'google-kgsearch'
const kGraph = KGSearch(process.env.KGSEARCH_API_KEY)

Search Google's Knowledge Graph

Use the .search() method to search Google's Knowledge Graph.

/* ... */{ query: 'Puerto Rico'}, (err, items) => {
  if (err) console.error(err)

The, callback) method takes params as a first argument. Under the hood the module converts these into query strings.

It also takes a callback function to handle the data received from the API.



Argument Type Description
api_key (required) string Enables access to the Google's Knowledge Graph Search API


Method of KGSearch(api_key)

Argument Type Description
params (required) object API query parameters (query, types, limit, etc.)
callback (required) function A function that handles the response data from the API

callback takes two arguments:

  1. err (for error handling; null if there are no errors)
  2. data (the data returned by the API)


Bug Reports & Feature Requests

Something does not work as expected or perhaps you think this module needs a feature? Please open an issue using GitHub's issue tracker. Please be as specific and straightforward as possible.


Pull Requests (PRs) are welcome. Make sure you follow the same basic stylistic conventions as the original code (i.e. "JavaScript standard code style")


The MIT License (MIT)

Copyright (c) 2016 Kristian Muñiz

Package Sidebar


npm i google-kgsearch

Weekly Downloads






Last publish


  • krismuniz