{"id":13494920,"url":"https://github.com/meetDeveloper/freeDictionaryAPI","last_synced_at":"2025-03-28T15:32:11.253Z","repository":{"id":37476709,"uuid":"133128687","full_name":"meetDeveloper/freeDictionaryAPI","owner":"meetDeveloper","description":"There was no free Dictionary API on the web when I wanted one for my friend, so I created one.","archived":false,"fork":false,"pushed_at":"2023-11-27T12:16:11.000Z","size":2505,"stargazers_count":2316,"open_issues_count":76,"forks_count":239,"subscribers_count":38,"default_branch":"master","last_synced_at":"2024-04-14T09:58:32.676Z","etag":null,"topics":["api","dictionary-api","dictonary","free-api","google","google-dictionary","scraper"],"latest_commit_sha":null,"homepage":"https://dictionaryapi.dev/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/meetDeveloper.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null},"funding":{"open_collective":"meetDeveloper","liberapay":"meetDeveloper","custom":["paypal.me/paytosuraj","https://www.buymeacoffee.com/meetDeveloper"]}},"created_at":"2018-05-12T08:39:04.000Z","updated_at":"2024-04-13T07:07:06.000Z","dependencies_parsed_at":"2023-12-18T19:43:19.162Z","dependency_job_id":"724051e5-7cc2-4a49-990a-5930153a3a42","html_url":"https://github.com/meetDeveloper/freeDictionaryAPI","commit_stats":{"total_commits":109,"total_committers":8,"mean_commits":13.625,"dds":0.5504587155963303,"last_synced_commit":"4f274a853dd7a352aa2a349d1b92624ff18a36a8"},"previous_names":["meetdeveloper/googledictionaryapi"],"tags_count":73,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meetDeveloper%2FfreeDictionaryAPI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meetDeveloper%2FfreeDictionaryAPI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meetDeveloper%2FfreeDictionaryAPI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/meetDeveloper%2FfreeDictionaryAPI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/meetDeveloper","download_url":"https://codeload.github.com/meetDeveloper/freeDictionaryAPI/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":222260454,"owners_count":16957157,"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":["api","dictionary-api","dictonary","free-api","google","google-dictionary","scraper"],"created_at":"2024-07-31T19:01:29.462Z","updated_at":"2024-10-31T09:31:35.461Z","avatar_url":"https://github.com/meetDeveloper.png","language":"JavaScript","readme":"# Free Dictionary API\n\nThere was no free Dictionary API on the web when I wanted one for my friend, so I created one.\n\n## Important Note\nThe API usage has been ramping up rapidly, making it difficult for me to keep the server running due to increased AWS costs.\n\nYour support directly helps the development of Dictionary API and keeps the server running.\n\n\u003ca href=\"https://www.buymeacoffee.com/meetdeveloper\"\u003e\u003cimg src=\"https://img.buymeacoffee.com/button-api/?text=Buy me a coffee\u0026emoji=\u0026slug=meetdeveloper\u0026button_colour=5F7FFF\u0026font_colour=ffffff\u0026font_family=Poppins\u0026outline_colour=000000\u0026coffee_colour=FFDD00\"\u003e\u003c/a\u003e\n\n## Getting Started\n\n### Usage \n\nThe basic syntax of a URL request to the API is shown below:\n\n`https://api.dictionaryapi.dev/api/\u003c--version--\u003e/entries/en/\u003c--word--\u003e`\n\nAs an example, to get definition of English word **hello** using _v2_, you can send request to\n\n`https://api.dictionaryapi.dev/api/v2/entries/en/hello` and the result returned will be:\n\n```json\n[\n  {\n    \"word\": \"hello\",\n    \"phonetic\": \"həˈləʊ\",\n    \"phonetics\": [\n      {\n        \"text\": \"həˈləʊ\",\n        \"audio\": \"//ssl.gstatic.com/dictionary/static/sounds/20200429/hello--_gb_1.mp3\"\n      },\n      {\n        \"text\": \"hɛˈləʊ\"\n      }\n    ],\n    \"origin\": \"early 19th century: variant of earlier hollo ; related to holla.\",\n    \"meanings\": [\n      {\n        \"partOfSpeech\": \"exclamation\",\n        \"definitions\": [\n          {\n            \"definition\": \"used as a greeting or to begin a phone conversation.\",\n            \"example\": \"hello there, Katie!\",\n            \"synonyms\": [],\n            \"antonyms\": []\n          }\n        ]\n      },\n      {\n        \"partOfSpeech\": \"noun\",\n        \"definitions\": [\n          {\n            \"definition\": \"an utterance of ‘hello’; a greeting.\",\n            \"example\": \"she was getting polite nods and hellos from people\",\n            \"synonyms\": [],\n            \"antonyms\": []\n          }\n        ]\n      },\n      {\n        \"partOfSpeech\": \"verb\",\n        \"definitions\": [\n          {\n            \"definition\": \"say or shout ‘hello’.\",\n            \"example\": \"I pressed the phone button and helloed\",\n            \"synonyms\": [],\n            \"antonyms\": []\n          }\n        ]\n      }\n    ]\n  }\n]\n```\n\n### Regarding V1 Version\nThe API earlier used to send response as shown below, but this structure of response was found out to be difficult to work with (you can take a look at these tickets [#32](https://github.com/meetDeveloper/freeDictionaryAPI/issues/32) and [#4](https://github.com/meetDeveloper/freeDictionaryAPI/issues/4)), based on feedback in these tickets I have updated the API to _v2_ version. But _v1_ version will always be supported for backward compatibility.\n\n```json\n[\n  {\n    \"word\": \"hello\",\n    \"phonetic\": \"həˈləʊ\",\n    \"phonetics\": [\n      {\n        \"text\": \"həˈləʊ\",\n        \"audio\": \"//ssl.gstatic.com/dictionary/static/sounds/20200429/hello--_gb_1.mp3\"\n      },\n      {\n        \"text\": \"hɛˈləʊ\"\n      }\n    ],\n    \"origin\": \"early 19th century: variant of earlier hollo ; related to holla.\",\n    \"meaning\": {\n      \"exclamation\": [\n        {\n          \"definition\": \"used as a greeting or to begin a phone conversation.\",\n          \"example\": \"hello there, Katie!\",\n          \"synonyms\": [],\n          \"antonyms\": []\n        }\n      ],\n      \"noun\": [\n        {\n          \"definition\": \"an utterance of ‘hello’; a greeting.\",\n          \"example\": \"she was getting polite nods and hellos from people\",\n          \"synonyms\": [],\n          \"antonyms\": []\n        }\n      ],\n      \"verb\": [\n        {\n          \"definition\": \"say or shout ‘hello’.\",\n          \"example\": \"I pressed the phone button and helloed\",\n          \"synonyms\": [],\n          \"antonyms\": []\n        }\n      ]\n    }\n  }\n]\n```\n\n### Paths\n\n| Location | Endpoint |\n| :-- | :-- |\n| Root path | `https://api.dictionaryapi.dev/api/\u003c--version--\u003e`|\n\n### HTTP request and query methods\n\n| Method | Endpoint | Description | Examples |\n| :-- | :-- | :-- | :-- |\n| `GET` | `/entries/en/\u003cYOUR_WORD\u003e`| Retrieves the definition of the given word. | [`/api/v2/entries/en/bliss`](https://api.dictionaryapi.dev/api/v2/entries/en/bliss) |\n\n## Future plans  \n\nYou can see existing and add new feature proposals on the projects GitHub page.\nPull requests are welcome!\n\nIf you need any assistance or find any bugs, feel free to contact me directly via [email](mailto:help@dictionaryapi.dev) or [create a new issue](https://github.com/meetDeveloper/freeDictionaryAPI/issues) on the GitHub page.\n\n## Support Me\nThis Dictionary API was initially created as an API that could be used by my friend for his project. I did not in my wildest dream thought that this API will become so popular, in few months this API took off and many people started to use it, initially I was able to manage the server costs but as number of requests started increasing, so did the server costs. Currently API has more than 10 million requests per month and to keep it running I need support of the community. I have planned few things in near future that will bring the cost down, but that will take some time. \n\nKindly help me keep running and developing this API. Thanks a lot for using my API, it feels good when your creation help other create their own projects.\n\n\u003ca href=\"https://www.buymeacoffee.com/meetdeveloper\"\u003e\u003cimg src=\"https://img.buymeacoffee.com/button-api/?text=Buy me a coffee\u0026emoji=\u0026slug=meetdeveloper\u0026button_colour=5F7FFF\u0026font_colour=ffffff\u0026font_family=Poppins\u0026outline_colour=000000\u0026coffee_colour=FFDD00\"\u003e\u003c/a\u003e\n\n## Related Projects\n\n### [Dictionary Anywhere](https://github.com/meetDeveloper/Dictionary-Anywhere)\n\nThe **Dictionary Anywhere** extension helps you stay focused on what you are reading by eliminating the need to search for meaning, \nDouble-clicking any word will view its definition in a small pop-up bubble. \nNow you never have to leave what you are reading to search for the meaning of the words you don't yet know.\n\nExtension is available for [Google Chrome](https://chrome.google.com/webstore/detail/dictionary-anywhere/hcepmnlphdfefjddkgkblcjkbpbpemac/) and [Mozilla Firefox](https://addons.mozilla.org/en-US/firefox/addon/dictionary-anyvhere).\n##### Enjoy Reading Uninterrupted!!!\n","funding_links":["https://opencollective.com/meetDeveloper","https://liberapay.com/meetDeveloper","paypal.me/paytosuraj","https://www.buymeacoffee.com/meetDeveloper","https://www.buymeacoffee.com/meetdeveloper","https://img.buymeacoffee.com/button-api/?text=Buy"],"categories":["JavaScript"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FmeetDeveloper%2FfreeDictionaryAPI","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FmeetDeveloper%2FfreeDictionaryAPI","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FmeetDeveloper%2FfreeDictionaryAPI/lists"}