A Simplified Google Dictionary API

Getting Started

To view the meaning of a specific word, enter the word at the root endpoint. GoogleDict API v2 now supports extended definitions on a given word.

GoogleDict v1

Eg. https://dict.niweera.gq/hello, will give you the Google dictionary definition of hello:

{
  "word": "hello",
  "definition": "used as a greeting or to begin a telephone conversation."
}

GoogleDict v2

Eg. https://dict.niweera.gq/v2/hello, will give you the Google dictionary definition of hello:

{
  "word": "hello",
  "definition": {
    "exclamation": ["used as a greeting or to begin a telephone conversation."],
    "noun": ["an utterance of ‘hello’; a greeting."],
    "verb": ["say or shout ‘hello’."]
  }
}

Paths

Location	Endpoint
v1 Root path	`https://dict.niweera.gq/`
v2 Root path	`https://dict.niweera.gq/v2`

HTTP request and query methods

Method	Endpoint	Query	Description	Examples
`GET`	`/`	`{word}`	Give JSON response with the definitions of the `{word}`.	`hello`
`GET`	`/v2`	`{word}`	Give JSON response with the definitions of the `{word}`.	`hello`

Invalid use of GoogleDict

Method	Endpoint	Query	Description	Examples
`GET`	`/`	`{word anotherWord}`	The API will only refer the first word given. All following words will be ignored. Please use only a single word in the query.	`hell fire`
`GET`	`/v2`	`{word anotherWord}`	The API will only refer the first word given. All following words will be ignored. Please use only a single word in the query.	`hell fire`

Related Projects

WordHunter

WordHunter application is under development. It provides possible words for given set of characters.

Contributing

Fork it (https://github.com/Niweera/googledict/fork)
Create your feature branch (git checkout -b feature/fooBar)
Commit your changes (git commit -am 'Add some fooBar')
Push to the branch (git push origin feature/fooBar)
Create a new Pull Request

Acknowledgement

Without the insights from this repo googleDictionaryAPI by meetDeveloper, the development of GoogleDict Dictionary API service would be impossible...

Niweera/googledict