dictionary-api

Overview

The dictionary API crawled word from google and parse the data in JSON format For now, API supports English only(en-US)

Usage

Syntax usage

Get definitions of word

GET https://dictionary-api-flask.herokuapp.com/dictionary-api/v1/word/?word=<<--word-->>&language=<<--en-US-->>

Get all synonyms of word

GET https://dictionary-api-flask.herokuapp.com/dictionary-api/v1/synonyms/?word=<<--word-->>&language=<<--en-US-->>

Get all antonyms of word

GET https://dictionary-api-flask.herokuapp.com/dictionary-api/v1/antonyms/?word=<<--word-->>&language=<<--en-US-->>

Example

Example HTTP request

GET https://dictionary-api-flask.herokuapp.com/dictionary-api/v1/?word=example&language=en-US

Example response output

{
  "meaning": [
    {
      "definitions": [
        {
          "antonyms": ["unimportant", "optional"],
          "definition": "of vital importance; crucial.",
          "examples": [
            "immediate action was imperative",
            "it is imperative that standards be maintained",
            "With reloading it is absolutely imperative we measure at least twice, maybe more.",
            "Illness, death and the cost of hip fractures make prevention imperative.",
            "For a moment, despite the obviously imperative differences in gender, they emerge as the twin epic heroes on the same side, fighting the same war against a common foe.",
            "In order to implement gender reform, it is imperative that gender bias in the legal framework of the country is removed.",
            "Thus, it is imperative that health communication scholars focus their efforts on adolescent patient-physician communication.",
            "It is imperative that couples should communicate in order to know the root of the conflict."
          ],
          "synonyms": [
            "vitally important",
            "of vital importance",
            "all-important",
            "vital",
            "crucial",
            "critical",
            "essential",
            "of the essence",
            "a matter of life and death",
            "of great consequence",
            "necessary",
            "indispensable",
            "exigent",
            "pressing",
            "urgent",
            "required",
            "compulsory",
            "mandatory",
            "obligatory"
          ]
        },
        {
          "antonyms": ["submissive"],
          "definition": "giving an authoritative command; peremptory.",
          "examples": [
            "the bell pealed again, a final imperative call",
            "The human desire for novelty is twinned with an equally imperative desire for continuity.",
            "It's an imperative and ornate exhortation to lay open your nerves and unabashedly, unapologetically feel."
          ],
          "synonyms": [
            "peremptory",
            "commanding",
            "imperious",
            "authoritative",
            "masterful",
            "lordly",
            "magisterial",
            "autocratic",
            "dictatorial",
            "domineering",
            "overbearing",
            "assertive",
            "firm",
            "insistent",
            "bossy",
            "high-handed",
            "overweening"
          ]
        }
      ],
      "partOfSpeech": "adjective"
    },
    {
      "definitions": [
        {
          "definition": "an essential or urgent thing.",
          "examples": [
            "free movement of labor was an economic imperative",
            "Such an imperative seems particularly urgent because of the vacuum at the top.",
            "Our successes have highlighted some essential imperatives for how we will continue to do business.",
            "The drama of history and biography is sacrificed to the imperative of ‘covering’ everything in a single volume.",
            "Given the imperative of global competition and the continued flow of efficiency gains from past investments in technology, the efficiency trend will not go into reverse.",
            "Applicants also showed an understanding of the imperative to enable teachers to grow and realize more of their own potential in their chosen profession.",
            "Currently, too many internet users fail to understand, or fail to act on, the imperative to protect themselves for the greater good.",
            "Job stress is caused by the lack of adequate staffing, and by the imperative for laboratory work to be error-free.",
            "Such an indication or a close relative's agreement (based on his knowledge of the donor's attitude and moral values) is imperative.",
            "But it is one of the noblest things this country has ever attempted abroad and it is a moral and strategic imperative that we give it our best shot.",
            "Chief among these challenges are the need for a new type of salesperson and the imperative to win acceptance of value-based prices by third-party payers.",
            "First, we see the imperative to view this work in cycles with multiple points of entry and modes of engagement."
          ]
        },
        {
          "definition": "a verb or phrase in the imperative mood.",
          "examples": [
            "Noteworthy in this meditation is the use of imperatives and action verbs, which are meant to activate the believer.",
            "Jon's utterance is an imperative, but it is not a command."
          ]
        }
      ],
      "partOfSpeech": "noun"
    }
  ],
  "phonetics": [
    {
      "audio": "//ssl.gstatic.com/dictionary/static/sounds/20200429/imperative--_us_1.mp3",
      "text": "əmˈperədiv"
    }
  ],
  "type": "data",
  "word": "imperative"
}

Milestone

• Implement data crawling function
• Parse data into JSON format
• Implement API with Flask
• Deploy API
• Write test cases
• Implement CI/CD workflow
• Implement synonyms/antonyms functionalities
• Support multiple languages