Contract a phrase to its acronym
Exactacronyms_contractDeterministic and authoritative — the canonical answer for this input.
Contract a full phrase to its canonical acronym — reverse of acronyms_expand. Takes 'Doctor of Medicine' and returns 'MD' with confidence. Exact (case/whitespace-insensitive) match only; no fuzzy matching. Supports the same industry and categories filters as expand. Processing multiple inputs? Use `acronyms_contract_batch` to do up to 500 in one call.
Parameters
valuestringrequiredFull phrase to contract (e.g. 'Doctor of Medicine').
industrystringoptionalcategoriesarrayoptionalmax_resultsintegeroptionalCall it
curl -X POST https://api.snipget.ai/v1/acronyms/contract \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{"value":"Doctor of Medicine"}'The Batch tab sends up to 1000 inputs in one call via /v1/acronyms/contract/batch.
Example response
{
"input": "Doctor of Medicine",
"candidates": [
{
"abbreviation": "MD",
"expansion": "Doctor of Medicine",
"industry": "healthcare",
"category": "degree",
"confidence": 0.98
}
],
"top": {
"abbreviation": "MD",
"expansion": "Doctor of Medicine",
"industry": "healthcare",
"category": "degree",
"confidence": 0.98
},
"industry_filter": null,
"category_filter": null,
"total_matches": 1,
"returned": 1
}FAQ
What does this do?
It is the reverse of expand. You give it a spelled-out phrase like Doctor of Medicine and it returns the standard short form, MD, drawn from the same maintained catalog. Useful when you have long titles in a spreadsheet and want the recognized abbreviations.
Will it match if my phrasing is a little different?
Only loosely. The match ignores capitalization and extra spaces, but it is otherwise exact, so a typo, a synonym, or a reworded phrase will not match. For approximate or fuzzy matching, that is a separate kind of tool, not this one.
Is the result trustworthy?
Yes. This is a deterministic, authoritative lookup, so the same phrase always returns the same acronym with the same confidence. It does not guess or generate new abbreviations.
Can I limit it to one industry?
Yes. Pass an industry, such as healthcare or legal, or a categories filter to narrow which meanings come back. Leave them off to search across all industries.
What if the phrase is not recognized?
You get a normal response with an empty candidate list and a confidence of 0, along with a reason, rather than an error. That tells you the phrase is not in the catalog or is worded differently than the canonical entry.