{"id":14976975,"url":"https://github.com/imshawan/pydictapi","last_synced_at":"2026-03-08T14:37:48.962Z","repository":{"id":62579879,"uuid":"390733894","full_name":"imshawan/PyDictAPI","owner":"imshawan","description":"An advanced Dictionary \u0026 Translator Module for Python","archived":false,"fork":false,"pushed_at":"2021-09-04T07:09:03.000Z","size":95,"stargazers_count":0,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-01T11:17:24.878Z","etag":null,"topics":["dictionaries","dictionary","dictionary-api","dictionary-app","dictionary-app-using-python","en-us","english-dictionary","linux","macos","meaning","pydictapi","pydictionary","pydictionaryapi","python","python3","system","windows","windows-10"],"latest_commit_sha":null,"homepage":"https://pypi.python.org/pypi/PyDictAPI","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/imshawan.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-07-29T13:31:20.000Z","updated_at":"2021-09-04T07:09:06.000Z","dependencies_parsed_at":"2022-11-03T21:01:01.161Z","dependency_job_id":null,"html_url":"https://github.com/imshawan/PyDictAPI","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imshawan%2FPyDictAPI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imshawan%2FPyDictAPI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imshawan%2FPyDictAPI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imshawan%2FPyDictAPI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/imshawan","download_url":"https://codeload.github.com/imshawan/PyDictAPI/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241355045,"owners_count":19949293,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dictionaries","dictionary","dictionary-api","dictionary-app","dictionary-app-using-python","en-us","english-dictionary","linux","macos","meaning","pydictapi","pydictionary","pydictionaryapi","python","python3","system","windows","windows-10"],"created_at":"2024-09-24T13:54:47.025Z","updated_at":"2026-03-08T14:37:48.883Z","avatar_url":"https://github.com/imshawan.png","language":"Python","readme":"[![PyDictAPI](https://img.shields.io/badge/PyDictAPI-Stable-limegreen)](https://github.com/imshawan/PyDictAPI)\n[![GitHub license](https://img.shields.io/github/license/imshawan/PyDictAPI)](https://github.com/imshawan/PyDictAPI/blob/master/LICENSE.txt)\n[![Latest Version](http://img.shields.io/pypi/v/PyDictAPI.svg?style=flat-square)](https://pypi.python.org/pypi/PyDictAPI/)\n[![Downloads](https://img.shields.io/pypi/dm/PyDictAPI.svg?style=flat-square)](https://pypi.python.org/pypi/PyDictAPI/)\n\n# PyDictAPI\n### An advanced Dictionary and Translator Module for Python\n\nPyDictAPI is a Dictionary Module for Python 3+ to get a detailed and well-structured meanings of a queried word in JSON format. PyDictAPI searches for the query on the web, if the query matches than it returns the Definitions/Examples/Synonyms/Antonyms as specified by the user. And incase of incorrect words, the response is returned as a suggestion of the correct word.\u003cbr\u003e\nAnd incase of wrong translation-query or language code, the source query is returned back.\n\n\u003e  **Sources:** [Dictionary.com](https://www.dictionary.com/), [Thesaurus](https://www.thesaurus.com/), [Lexico](https://www.lexico.com/)\n\nThis module uses Requests and bs4 dependencies to scrape the web and find the definitions and return it in a well-structured JSON document\n\n## Installation\n\nPyDictAPI can be easily installed through [PIP](https://pip.pypa.io/en/stable/)\n\n```\npip install PyDictAPI\n```\n### [View Changelog](https://github.com/imshawan/PyDictAPI/blob/master/CHANGELOG.md)\n\n###  Both the Finder and Translator class takes an arguement \"jsonify\" that is set to False by default. If jsonify is set to True, than the processed queries are returned in JSON. While by default the queries are returned in the form of a Python List (Array)\n\n## Dictionary searches\n\nDictionary searches can be performed by creating a Finder instance and later calling findMeanings() that takes a word as an arguement.\n\nFor example,\n\n```python\nfrom PyDictAPI import Finder\nMeanings = Finder(jsonify=True)\n# Use can use Finder() without 'jsonify' to get response in the form of a Python List\nprint(Meanings.findMeanings('apple'))\n```\n\nThis is will create a local instance of the Finder class and will return results containing the meanings of the word. \u003cbr\u003e\nThe Output can be seen as:\n\n```\n{\n  \"word\": \"Apple\",\n  \"meanings\": [\n    {\n      \"partOfSpeech\": \"Noun\",\n      \"definition\": \"The usually round, red or yellow, edible fruit of a small tree, Malus sylvestris, of the rose family.\"  \n    },\n    {\n      \"partOfSpeech\": \"Noun\",\n      \"definition\": \"A rosaceous tree, Malus sieversii, native to Central Asia but widely cultivated in temperate regions in many varieties, having pink or white fragrant flowers and firm rounded edible fruits. See also crab apple\"\n    }\n  ]\n}                                                                       \n```\n## Exceptions\n\n### Case - 1: If the word is spelt incorrectly\n\n```python\nfrom PyDictAPI import Finder\nMeanings = Finder()\n# jsonify is set to false by default, so the output returned is in plain string.\nprint(Meanings.findMeanings('helloooo'))\n```\nIncase of incorrect words, the response is returned as a suggestion of the correct word \u003cbr\u003e\nThe Response can be seen as:\n\n```\nCouldn't find results for helloooo, Did you mean hello?\n```\n\n### Case - 2: If the word doesn't exist\n\n```python\nfrom PyDictAPI import Finder\nMeanings = Finder()\nprint(Meanings.findMeanings('abcdefghijkl'))\n```\nThe Response can be seen as:\n\n```\nCouldn't find any results for ABCDEFGHIJKL, try searching the web...\n```\n## Finding Examples, Synonyms and Antonyms\n\n```python\nfrom PyDictAPI import Finder\nMeanings = Finder()\n# jsonify is set to false by default, so the output returned is in python list.\n\nprint(Meanings.findUsage('help', 2)) #Finding Examples\n# Here 2 defines the maximum number of examples to be included in the response, \n# by default it is set to 5\n\nprint(Meanings.findSynonyms('help', 4)) #Finding Synonyms\nprint(Meanings.findAntonyms('help', 4)) #Finding Antonyms\n\n```\n\n### Outputs for Examples, Synonyms and Antonyms\n\nExamples: \u003cbr\u003e\n```\n['She helped him find a buyer', 'Long-term funding is desperately being sought for a voluntary service that helps local victims of domestic violence.']\n```\n\nSynonyms: \u003cbr\u003e\n```\n['Advice', 'Aid', 'Benefit', 'Comfort']\n```\n\nAntonyms: \u003cbr\u003e\n```\n['Blockage', 'Encumbrance', 'Handicap', 'Hindrance']\n```\n\n## Using the Translator\n\n```python\nfrom PyDictAPI import Translate\nt = Translate(jsonify=True)\nprint(t.languages_help()) # Prints all supported languages with language code\n\nprint(t.translateItems(\"Hello, How are you?\", \"hi\")) # hi: Hindi\n\n# Translates text according to the language code\n```\nOutput:\n```\n{'query': 'Hello, How are you?', 'language': 'Hindi', 'translation': 'नमस्कार किसे हो आप?'}\n```\n\n## About\n\nCopyright (c) 2021 Shawan Mandal.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimshawan%2Fpydictapi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fimshawan%2Fpydictapi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimshawan%2Fpydictapi/lists"}