collins-dictionary-api-client
Readme
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.
Security News
NIST's new AI Risk Management Framework aims to enhance the security and reliability of generative AI systems and address the unique challenges of malicious AI exploits.
Security News
This episode of the Risky Biz podcast discusses how the rise of small open source packages and the shift towards individual maintainers makes the ecosystem more vulnerable to supply chain attacks.
Product
Streamline your login process and enhance security by enabling Single Sign-On (SSO) on the Socket platform, now available for all customers on the Enterprise plan, supporting 20+ identity providers.