collins-dictionary-api-client
Advanced tools
Command Line Interface and python library to make requests to the Collins dictionary API.
# Command line interface
$ pipx install collins-dictionary-api-client
# Library
$ pip install collins-dictionary-api-client
$ collins-dictionary-api-client --secret-key <SECRET_KEY> search garden
{"resultNumber":69,"results":[{"entryLabel":"garden","entryUrl":"http://localhost/api/v1/dictionaries/english/entries/garden_1","entryId":"garden_1"}..."
Type collins-dictionary-api-client --help to see all available options.
The following methods are implemented in the client.
Get a list of entry ids corresponding to the search term.
{
"resultNumber": 1,
"results": [
{
"entryLabel": "legitim",
"entryUrl": "http://localhost/api/v1/dictionaries/english/entries/legitim_1",
"entryId": "legitim_1"
}
],
"dictionaryCode": "english",
"currentPageIndex": 1,
"pageNumber": 1
}
Get a list of suggestions corresponding to the input word.
The suggested words are close to the input word in a lexicographic sense. For example, share a good portion of the prefix or the suffix.
{
"searchTerm": "legitim",
"dictionaryCode": "english",
"suggestions": [
"legit",
"legitimist",
"legitimize",
"legitimate",
"flexitime",
"legitimizer",
"legitimator",
"legitimiser",
"gregatim",
"legalism"
]
}
Get the metadata of the first entry found for the searched word.
{
"topics": [],
"dictionaryCode": "english",
"entryLabel": "legitim",
"entryContent": "<div class=\"entry_container\"><div class=\"entry lang_en-gb\" id=\"legitim_1\"><span class=\"inline\"><h1 class=\"hwd\">legitim<\/h1><span> (<\/span><span class=\"pron\" type=\"\">ˈlɛdʒɪtɪm<\/span><span>)<\/span><\/span><div class=\"hom\" id=\"legitim_1.1\"><span class=\"gramGrp\"><span> <\/span><span class=\"pos\">noun<\/span><\/span><div class=\"sense\"><span> <\/span><span class=\"lbl\">Scots law<\/span><span> <\/span><span class=\"def\">the part of a person's moveable estate that is inherited by his or her children on that person's death<\/span><\/div><!-- End of DIV sense--><\/div><!-- End of DIV hom--><\/div><!-- End of DIV entry lang_en-gb--><\/div><!-- End of DIV entry_container-->\n",
"entryUrl": "http://localhost/api/v1/dictionaries/english/entries/legitim_1",
"format": "html",
"entryId": "legitim_1"
}
Get the first entry found for the searched word.
{
"topics": [],
"dictionaryCode": "english",
"entryLabel": "legit",
"entryContent": "<div class=\"entry_container\"><div class=\"entry lang_en-gb\" id=\"legit_1\"><span class=\"inline\"><h1 class=\"hwd\">legit<\/h1><span> (<\/span><span class=\"pron\" type=\"\">lɪˈdʒɪt<a href=\"#\" class=\"playback\"><img src=\"https://api.collinsdictionary.com/external/images/redspeaker.gif?version=2016-11-09-0913\" alt=\"Pronunciation for legit\" class=\"sound\" title=\"Pronunciation for legit\" style=\"cursor: pointer\"/><\/a><audio type=\"pronunciation\" title=\"legit\"><source type=\"audio/mpeg\" src=\"https://api.collinsdictionary.com/media/sounds/sounds/e/en_/en_gb/en_gb_legit.mp3\"/>Your browser does not support HTML5 audio.<\/audio><\/span><span>)<\/span><span class=\"lbl\"><span> <\/span>slang<\/span><\/span><div class=\"hom\" id=\"legit_1.1\"><span class=\"gramGrp\"><span> <\/span><span class=\"pos\">adjective<\/span><\/span><div class=\"sense\"><span class=\"sensenum\"> 1 <\/span><span class=\"xr\"><span class=\"lbl\">short for<\/span><span> <\/span>\n \n \t\t<a data-resource=\"english\" data-topic=\"legitimate_1\" href=\"\">legitimate<\/a><\/span><\/div><!-- End of DIV sense--><\/div><!-- End of DIV hom--><div class=\"hom\" id=\"legit_1.2\"><span> <br/>▷ <\/span><span class=\"gramGrp\"><span class=\"pos\">noun<\/span><\/span><div class=\"sense\"><span class=\"sensenum\"> 2 <\/span><span class=\"def\">legitimate or professionally respectable drama<\/span><\/div><!-- End of DIV sense--><\/div><!-- End of DIV hom--><\/div><!-- End of DIV entry lang_en-gb--><\/div><!-- End of DIV entry_container-->\n",
"entryUrl": "http://localhost/api/v1/dictionaries/english/entries/legit_1",
"format": "html",
"entryId": "legit_1"
}
Get a list of pronunciations.
Each pronunciation entry contains a URL to a mp3 file.
[
{
"dictionaryCode": "english",
"pronunciationUrl": "https://api.collinsdictionary.com/media/sounds/sounds/e/en_/en_gb/en_gb_legit.mp3",
"lang": "uk",
"entryId": "legit_1"
}
]
Get a list of entries related to the input word.
The returned words or expressions are in the same semantic scope of the input word.
{
"nearbyFollowingEntries": [
{
"entryLabel": "legitim",
"entryUrl": "http://localhost/api/v1/dictionaries/english/entries/legitim_1",
"entryId": "legitim_1"
},
{
"entryLabel": "legitimate",
"entryUrl": "http://localhost/api/v1/dictionaries/english/entries/legitimate_1",
"entryId": "legitimate_1"
},
{
"entryLabel": "legitimator",
"entryUrl": "http://localhost/api/v1/dictionaries/english/entries/legitimator_1",
"entryId": "legitimator_1"
},
{
"entryLabel": "legitimiser",
"entryUrl": "http://localhost/api/v1/dictionaries/english/entries/legitimiser_1",
"entryId": "legitimiser_1"
},
{
"entryLabel": "legitimist",
"entryUrl": "http://localhost/api/v1/dictionaries/english/entries/legitimist_1",
"entryId": "legitimist_1"
},
{
"entryLabel": "legitimistic",
"entryUrl": "http://localhost/api/v1/dictionaries/english/entries/legitimistic_1",
"entryId": "legitimistic_1"
},
{
"entryLabel": "legitimize",
"entryUrl": "http://localhost/api/v1/dictionaries/english/entries/legitimize_1",
"entryId": "legitimize_1"
},
{
"entryLabel": "legitimizer",
"entryUrl": "http://localhost/api/v1/dictionaries/english/entries/legitimizer_1",
"entryId": "legitimizer_1"
},
{
"entryLabel": "legless",
"entryUrl": "http://localhost/api/v1/dictionaries/english/entries/legless_1",
"entryId": "legless_1"
},
{
"entryLabel": "leglessness",
"entryUrl": "http://localhost/api/v1/dictionaries/english/entries/leglessness_1",
"entryId": "leglessness_1"
}
],
"dictionaryCode": "english",
"nearbyPrecedingEntries": [
{
"entryLabel": "legionnaire's disease",
"entryUrl": "http://localhost/api/v1/dictionaries/english/entries/legionnaires-disease_1_1",
"entryId": "legionnaires-disease_1_1"
},
{
"entryLabel": "legislate",
"entryUrl": "http://localhost/api/v1/dictionaries/english/entries/legislate_1",
"entryId": "legislate_1"
},
{
"entryLabel": "legislation",
"entryUrl": "http://localhost/api/v1/dictionaries/english/entries/legislation_1",
"entryId": "legislation_1"
},
{
"entryLabel": "legislative",
"entryUrl": "http://localhost/api/v1/dictionaries/english/entries/legislative_1",
"entryId": "legislative_1"
},
{
"entryLabel": "legislative assembly",
"entryUrl": "http://localhost/api/v1/dictionaries/english/entries/legislative-assembly_1",
"entryId": "legislative-assembly_1"
},
{
"entryLabel": "legislative council",
"entryUrl": "http://localhost/api/v1/dictionaries/english/entries/legislative-council_1",
"entryId": "legislative-council_1"
},
{
"entryLabel": "legislator",
"entryUrl": "http://localhost/api/v1/dictionaries/english/entries/legislator_1",
"entryId": "legislator_1"
},
{
"entryLabel": "legislatorial",
"entryUrl": "http://localhost/api/v1/dictionaries/english/entries/legislatorial_1",
"entryId": "legislatorial_1"
},
{
"entryLabel": "legislature",
"entryUrl": "http://localhost/api/v1/dictionaries/english/entries/legislature_1",
"entryId": "legislature_1"
},
{
"entryLabel": "legist",
"entryUrl": "http://localhost/api/v1/dictionaries/english/entries/legist_1",
"entryId": "legist_1"
}
],
"entryId": "legit_1"
}
Please reference to our contribution and code-of-conduct
FAQs
Client to the Collins dictionary API
We found that collins-dictionary-api-client demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Application Security
/Security News
Socket CEO Feross Aboukhadijeh and a16z partner Joel de la Garza discuss vibe coding, AI-driven software development, and how the rise of LLMs, despite their risks, still points toward a more secure and innovative future.
Research
/Security News
Threat actors hijacked Toptal’s GitHub org, publishing npm packages with malicious payloads that steal tokens and attempt to wipe victim systems.
Research
/Security News
Socket researchers investigate 4 malicious npm and PyPI packages with 56,000+ downloads that install surveillance malware.