google-ngram

A simple package to interact with the Google Books Ngram API.

Example Usage:

const ngram=require('google-ngram')

//simple usage
ngram.getNGram('the').then(r => console.log(r))

//with options
ngram.getNGram('the', {year_start: 1920, corpus: 10}).then(r => console.log(r))

//multiple words
ngram.getNGram('the, and').then(r => console.log(r))

//with wildcard
ngram.getNGram('the *').then(r => console.log(r))

getNGram(Content, Options) => Promise: Array

Content

| Type | Notes | | --- | --- | | String | Required |

Options

| Type | Parameters | Default Values | Notes | | --- | --- | --- | --- | | Object | {corpus: int, smoothing: int, year_start: int, year_end: int, case_insensitive: boolean} (all are optional)| {corpus: 26 (English Corpus), smoothing: 3, year_start: 1800, year_end: 2019, case_insensitive: false} | Optional |

Parameter Information:

| Corpus | Number | | ---| ---| | English 2019 (Default) |26| | American English 2019 | 28 | | British English | 29 | | English Fiction | 27 | | Chinese(Simplified) | 34 | | French | 30 |

Returned Data:

[
  {
    "ngram": "<word>",
    "parent": "", //used for wildcard
    "type": "NGRAM",
    "timeseries": [
      0.057974955067038536,
      0.057649505138397214,
      0.057653142139315605,
      0.05750594554202897,
      ...
    ]
  }
  ... //for multiple words or wildcard
]