{"resourcePath":"/word","apis":[{"path":"/word.{format}/{word}/examples","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return examples for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"includeDuplicates","description":"Show duplicate examples from different sources","required":false,"allowableValues":{"values":["false","true"],"valueType":"LIST"},"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"contentProvider","description":"Return results from a specific ContentProvider","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"useCanonical","description":"If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested.","required":false,"allowableValues":{"values":["false","true"],"valueType":"LIST"},"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"skip","description":"Results to skip","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns examples for a word","httpMethod":"GET","responseTypeInternal":"com.wordnik.corpus.model.ExampleSearchResults","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getExamples","responseClass":"exampleSearchResults"}]},{"path":"/word.{format}/{word}","description":"","operations":[{"parameters":[{"name":"word","description":"String value of WordObject to return","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"useCanonical","defaultValue":"false","description":"If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested.","required":false,"allowableValues":{"values":["false","true"],"valueType":"LIST"},"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"includeSuggestions","description":"Return suggestions (for correct spelling, case variants, etc.)","required":false,"allowableValues":{"values":["false","true"],"valueType":"LIST"},"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Given a word as a string, returns the WordObject that represents it","httpMethod":"GET","responseTypeInternal":"com.wordnik.corpus.entity.Word","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getWord","responseClass":"wordObject"}]},{"path":"/word.{format}/{word}/definitions","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return definitions for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"partOfSpeech","description":"CSV list of part-of-speech types","required":false,"allowableValues":{"values":["noun","adjective","verb","adverb","interjection","pronoun","preposition","abbreviation","affix","article","auxiliary-verb","conjunction","definite-article","family-name","given-name","idiom","imperative","noun-plural","noun-posessive","past-participle","phrasal-prefix","proper-noun","proper-noun-plural","proper-noun-posessive","suffix","verb-intransitive","verb-transitive"],"valueType":"LIST"},"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"includeRelated","defaultValue":"false","description":"Return related words with definitions","required":false,"allowableValues":{"values":["true","false"],"valueType":"LIST"},"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"sourceDictionaries","description":"If 'all' is received, results are returned from all sources. If multiple values are received (e.g. 'century,wiktionary'), results are returned from the first specified dictionary that has definitions. If left blank, results are returned from the first dictionary that has definitions. By default, dictionaries are searched in this order: ahd, wiktionary, webster, century, wordnet","required":false,"allowableValues":{"values":["all","ahd","century","wiktionary","webster","wordnet"],"valueType":"LIST"},"dataType":"string","allowMultiple":true,"paramType":"query"},{"name":"useCanonical","defaultValue":"false","description":"If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested.","required":false,"allowableValues":{"values":["false","true"],"valueType":"LIST"},"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"includeTags","defaultValue":"false","description":"Return a closed set of XML tags in response","required":false,"allowableValues":{"values":["false","true"],"valueType":"LIST"},"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Return definitions for a word","httpMethod":"GET","responseTypeInternal":"com.wordnik.corpus.dictionary.entity.Definition","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No definitions found.","code":404}],"nickname":"getDefinitions","responseClass":"List[definition]"}]},{"path":"/word.{format}/{word}/topExample","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch examples for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"contentProvider","description":"Return results from a specific ContentProvider","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"useCanonical","description":"If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested.","required":false,"allowableValues":{"values":["false","true"],"valueType":"LIST"},"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns a top example for a word","httpMethod":"GET","responseTypeInternal":"com.wordnik.corpus.model.Example","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getTopExample","responseClass":"example"}]},{"path":"/word.{format}/{word}/pronunciations","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get pronunciations for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"useCanonical","description":"If true will try to return a correct word root ('cats' -> 'cat'). If false returns exactly what was requested.","required":false,"allowableValues":{"values":["false","true"],"valueType":"LIST"},"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"sourceDictionary","description":"Get from a single dictionary.","required":false,"allowableValues":{"values":["ahd","century","cmu","macmillan","wiktionary","webster","wordnet"],"valueType":"LIST"},"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"typeFormat","description":"Text pronunciation type","required":false,"allowableValues":{"values":["ahd","arpabet","gcide-diacritical","IPA"],"valueType":"LIST"},"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns text pronunciations for a given word","httpMethod":"GET","responseTypeInternal":"com.wordnik.corpus.dictionary.entity.TextPron","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getTextPronunciations","responseClass":"List[textPron]"}]},{"path":"/word.{format}/{word}/hyphenation","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get syllables for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"useCanonical","description":"If true will try to return a correct word root ('cats' -> 'cat'). If false returns exactly what was requested.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"sourceDictionary","description":"Get from a single dictionary. Valid options: ahd, century, wiktionary, webster, and wordnet.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns syllable information for a word","httpMethod":"GET","responseTypeInternal":"com.wordnik.corpus.dictionary.entity.Syllable","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getHyphenation","responseClass":"List[syllable]"}]},{"path":"/word.{format}/{word}/frequency","description":"","operations":[{"parameters":[{"name":"word","description":"Word to return","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"useCanonical","description":"If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"startYear","description":"Starting Year","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"endYear","description":"Ending Year","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns word usage over time","httpMethod":"GET","responseTypeInternal":"com.wordnik.corpus.entity.FrequencySummary","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No results.","code":404}],"nickname":"getWordFrequency","responseClass":"frequencySummary"}]},{"path":"/word.{format}/{word}/phrases","description":"","operations":[{"parameters":[{"name":"word","description":"Word to fetch phrases for","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"wlmi","description":"Minimum WLMI for the phrase","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"useCanonical","description":"If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested.","required":false,"allowableValues":{"values":["false","true"],"valueType":"LIST"},"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches bi-gram phrases for a word","httpMethod":"GET","responseTypeInternal":"com.wordnik.corpus.ngram.entity.Bigram","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getPhrases","responseClass":"List[bigram]"}]},{"path":"/word.{format}/{word}/related","description":"","operations":[{"parameters":[{"name":"word","description":"Word for which to return related words","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"partOfSpeech","description":"CSV list of part-of-speech types","required":false,"allowableValues":{"values":["noun","adjective","verb","adverb","interjection","pronoun","preposition","abbreviation","affix","article","auxiliary-verb","conjunction","definite-article","family-name","given-name","idiom","imperative","noun-plural","noun-posessive","past-participle","phrasal-prefix","proper-noun","proper-noun-plural","proper-noun-posessive","suffix","verb-intransitive","verb-transitive"],"valueType":"LIST"},"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"sourceDictionary","description":"Get data from a single dictionary","required":false,"allowableValues":{"values":["ahd"," century"," wiktionary"," webster"," wordnet"],"valueType":"LIST"},"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"useCanonical","description":"If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested.","required":false,"allowableValues":{"values":["false","true"],"valueType":"LIST"},"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"type","description":"Relationship type","required":false,"allowableValues":{"values":["synonym","antonym","variant","equivalent","cross-reference","related-word","rhyme","form","etymologically-related-term","hypernym","hyponym","inflected-form","primary","same-context","verb-form","verb-stem","unknown"],"valueType":"LIST"},"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Return related words (thesaurus data) for a word","httpMethod":"GET","responseTypeInternal":"com.wordnik.corpus.dictionary.entity.Related","errorResponses":[{"reason":"Invalid word supplied.","code":400},{"reason":"No definitions found.","code":404}],"nickname":"getRelated","responseClass":"List[related]"}]},{"path":"/word.{format}/{word}/audio","description":"","operations":[{"parameters":[{"name":"word","description":"Word to get audio for.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"useCanonical","description":"Use the canonical form of the word.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches audio metadata for a word.","httpMethod":"GET","responseTypeInternal":"com.wordnik.community.entity.AudioFileMetadata","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getAudio","responseClass":"List[audioFile]","notes":"The metadata includes a time-expiring fileUrl which allows reading the audio file directly from the API.  Currently only audio pronunciations from the American Heritage Dictionary in mp3 format are supported."}]}],"apiVersion":"4.0","swaggerVersion":"1.1-SNAPSHOT","basePath":"http://api.wordnik.com/v4","models":{"Syllable":{"properties":{"text":{"type":"string"}},"id":"syllable"},"AudioType":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"audioType"},"Facet":{"properties":{"facetValues":{"type":"array","items":{"$ref":"facetValue"}},"name":{"type":"string"}},"id":"facet"},"Note":{"properties":{"appliesTo":{"type":"array","items":{"type":"string"}},"value":{"type":"string"}},"id":"note"},"FacetValue":{"properties":{"count":{"type":"long"},"value":{"type":"string"}},"id":"facetValue"},"WordObject":{"properties":{"id":{"type":"long","required":true},"word":{"type":"string"},"vulgar":{"type":"string"}},"id":"wordObject"},"Related":{"properties":{"words":{"type":"array","items":{"type":"string"}}},"id":"related"},"ScoredWord":{"properties":{"position":{"type":"int"},"id":{"type":"long"},"docTermCount":{"type":"int"},"lemma":{"type":"string"},"wordType":{"type":"string"},"score":{"type":"float"},"sentenceId":{"type":"long"},"word":{"type":"string"},"stopword":{"type":"boolean"},"baseWordScore":{"type":"double"},"partOfSpeech":{"type":"string"}},"id":"scoredWord"},"Citation":{"properties":{"cite":{"type":"string"},"source":{"type":"string"}},"id":"citation"},"ExampleSearchResults":{"properties":{"facets":{"type":"array","items":{"$ref":"facet"}},"examples":{"type":"array","items":{"$ref":"example"}}},"id":"exampleSearchResults"},"Category":{"properties":{"id":{"type":"long","required":true},"name":{"type":"string"}},"id":"category"},"Example":{"properties":{"id":{"type":"long"},"exampleId":{"type":"long"},"title":{"type":"string"},"text":{"type":"string"},"score":{"type":"scoredWord"},"sentence":{"type":"sentence"},"word":{"type":"string"},"provider":{"type":"contentProvider"},"year":{"type":"integer"},"rating":{"type":"float"},"documentId":{"type":"long"},"url":{"type":"string"}},"id":"example"},"Root":{"properties":{"id":{"type":"long","required":true},"name":{"type":"string"},"categories":{"type":"array","items":{"$ref":"category"}}},"id":"root"},"Sentence":{"properties":{"hasScoredWords":{"type":"boolean"},"id":{"type":"long"},"scoredWords":{"type":"array","items":{"$ref":"scoredWord"}},"display":{"type":"string"},"rating":{"type":"int"},"documentMetadataId":{"type":"long"}},"id":"sentence"},"ExampleUsage":{"properties":{"text":{"type":"string"}},"id":"ExampleUsage"},"ContentProvider":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"contentProvider"},"AudioFile":{"properties":{"attributionUrl":{"type":"string"},"commentCount":{"type":"int"},"voteCount":{"type":"integer"},"fileUrl":{"type":"string"},"audioType":{"type":"string"},"id":{"type":"long","required":true},"duration":{"type":"double"},"attributionText":{"type":"string"},"createdBy":{"type":"string"},"description":{"type":"string"},"createdAt":{"type":"Date"},"voteWeightedAverage":{"type":"float"},"voteAverage":{"type":"float"},"word":{"type":"string"}},"id":"audioFile"},"Bigram":{"properties":{"count":{"type":"long"},"gram2":{"type":"string"},"gram1":{"type":"string"},"wlmi":{"type":"double"},"mi":{"type":"double"}},"id":"bigram"},"Label":{"properties":{"text":{"type":"string"}},"id":"Label"},"Frequency":{"properties":{"count":{"type":"long"},"year":{"type":"int"}},"id":"frequency"},"FrequencySummary":{"properties":{"unknownYearCount":{"type":"int"},"totalCount":{"type":"long"},"frequencyString":{"type":"string"},"word":{"type":"string"},"frequency":{"type":"array","items":{"$ref":"frequency"}}},"id":"frequencySummary"},"TextPron":{"properties":{"raw":{"type":"string"},"rawType":{"type":"string"}},"id":"textPron"},"Definition":{"properties":{"extendedText":{"type":"string"},"text":{"type":"string"},"sourceDictionary":{"type":"string"},"citations":{"type":"array","items":{"$ref":"citation"}},"labels":{"type":"array","items":{"$ref":"Label"}},"score":{"type":"float"},"exampleUses":{"type":"array","items":{"$ref":"ExampleUsage"}},"attributionUrl":{"type":"string"},"seqString":{"type":"string"},"attributionText":{"type":"string"},"relatedWords":{"type":"array","items":{"$ref":"related"}},"word":{"type":"string"},"notes":{"type":"array","items":{"$ref":"note"}},"textProns":{"type":"array","items":{"$ref":"textPron"}},"partOfSpeech":{"type":"string"}},"id":"definition"},"PartOfSpeech":{"properties":{"roots":{"type":"array","items":{"$ref":"root"}},"storageAbbr":{"type":"array","items":{"type":"string"}},"allCategories":{"type":"array","items":{"$ref":"category"}}},"id":"partOfSpeech"}}}