{"resourcePath":"/words","apis":[{"path":"/words.{format}/search","description":"","operations":[{"parameters":[{"name":"query","description":"Search term","required":true,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"caseSensitive","defaultValue":"true","description":"Search case sensitive","required":false,"allowableValues":{"values":["true","false"],"valueType":"LIST"},"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"includePartOfSpeech","description":"Only include these comma-delimited parts of speech","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":"excludePartOfSpeech","description":"Exclude these comma-delimited parts of speech","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"minCorpusCount","defaultValue":"5","description":"Minimum corpus frequency for terms","required":false,"allowableValues":{"max":"Infinity","min":0.0,"valueType":"RANGE"},"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"maxCorpusCount","description":"Maximum corpus frequency for terms","required":false,"allowableValues":{"max":"Infinity","min":0.0,"valueType":"RANGE"},"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"minDictionaryCount","defaultValue":"1","description":"Minimum number of dictionary entries for words returned","required":false,"allowableValues":{"max":"Infinity","min":0.0,"valueType":"RANGE"},"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"maxDictionaryCount","description":"Maximum dictionary definition count","required":false,"allowableValues":{"max":"Infinity","min":0.0,"valueType":"RANGE"},"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"minLength","defaultValue":"1","description":"Minimum word length","required":false,"allowableValues":{"max":1024.0,"min":0.0,"valueType":"RANGE"},"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"maxLength","description":"Maximum word length","required":false,"allowableValues":{"max":1024.0,"min":0.0,"valueType":"RANGE"},"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"skip","defaultValue":"0","description":"Results to skip","required":false,"allowableValues":{"max":1000.0,"min":0.0,"valueType":"RANGE"},"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","defaultValue":"10","description":"Maximum number of results to return","required":false,"allowableValues":{"max":1000.0,"min":1.0,"valueType":"RANGE"},"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Searches words.","httpMethod":"GET","responseTypeInternal":"com.wordnik.corpus.stats.entity.WordFrequency","errorResponses":[{"reason":"Invalid term supplied.","code":400},{"reason":"No results.","code":404}],"nickname":"searchWords","responseClass":"List[wordFrequency]"}]},{"path":"/words.{format}/wordOfTheDay","description":"","operations":[{"parameters":[{"name":"date","description":"Fetches by date in yyyy-MM-dd","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"category","description":"Filters response by category","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"creator","description":"Filters response by username","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns a specific WordOfTheDay","httpMethod":"GET","responseTypeInternal":"com.wordnik.community.entity.WordOfTheDay","nickname":"getWordOfTheDay","responseClass":"WordOfTheDay"}]},{"path":"/words.{format}/search/{query}","description":"","operations":[{"parameters":[{"name":"query","description":"Search query","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"caseSensitive","defaultValue":"true","description":"Search case sensitive","required":false,"allowableValues":{"values":["true","false"],"valueType":"LIST"},"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"includePartOfSpeech","description":"Only include these comma-delimited parts of speech","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":"excludePartOfSpeech","description":"Exclude these comma-delimited parts of speech","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"minCorpusCount","defaultValue":"5","description":"Minimum corpus frequency for terms","required":false,"allowableValues":{"max":"Infinity","min":0.0,"valueType":"RANGE"},"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"maxCorpusCount","description":"Maximum corpus frequency for terms","required":false,"allowableValues":{"max":"Infinity","min":0.0,"valueType":"RANGE"},"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"minDictionaryCount","defaultValue":"1","description":"Minimum number of dictionary entries","required":false,"allowableValues":{"max":"Infinity","min":0.0,"valueType":"RANGE"},"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"maxDictionaryCount","description":"Maximum dictionary count","required":false,"allowableValues":{"max":"Infinity","min":0.0,"valueType":"RANGE"},"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"minLength","defaultValue":"1","description":"Minimum word length","required":false,"allowableValues":{"max":1024.0,"min":0.0,"valueType":"RANGE"},"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"maxLength","description":"Maximum word length","required":false,"allowableValues":{"max":1024.0,"min":0.0,"valueType":"RANGE"},"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"skip","defaultValue":"0","description":"Results to skip","required":false,"allowableValues":{"max":1000.0,"min":0.0,"valueType":"RANGE"},"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"limit","defaultValue":"10","description":"Maximum number of results to return","required":false,"allowableValues":{"max":1000.0,"min":1.0,"valueType":"RANGE"},"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Searches words.","httpMethod":"GET","responseTypeInternal":"com.wordnik.index.word.WordSearchResults","errorResponses":[{"reason":"Invalid query supplied.","code":400}],"nickname":"searchWordsNew","responseClass":"wordSearchResults"}]},{"path":"/words.{format}/randomWords","description":"","operations":[{"parameters":[{"name":"hasDictionaryDef","description":"Only return words with dictionary definitions","required":false,"allowableValues":{"values":["false","true"],"valueType":"LIST"},"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"includePartOfSpeech","description":"CSV part-of-speech values to include","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":"excludePartOfSpeech","description":"CSV part-of-speech values to exclude","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":"minCorpusCount","description":"Minimum corpus frequency for terms (integer)","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"maxCorpusCount","description":"Maximum corpus frequency for terms (integer)","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"minDictionaryCount","description":"Minimum dictionary count (integer)","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"maxDictionaryCount","description":"Maximum dictionary count (integer)","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"minLength","description":"Minimum word length (characters)","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"maxLength","description":"Maximum word length (characters)","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"sortBy","description":"Attribute to sort by","required":false,"allowableValues":{"values":["alpha","count"],"valueType":"LIST"},"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"sortOrder","description":"Sort direction","required":false,"allowableValues":{"values":["asc","desc"],"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 an array of random WordObjects","httpMethod":"GET","responseTypeInternal":"com.wordnik.corpus.entity.Word","errorResponses":[{"reason":"Invalid term supplied.","code":400},{"reason":"No results.","code":404}],"nickname":"getRandomWords","responseClass":"List[wordObject]"}]},{"path":"/words.{format}/randomWord","description":"","operations":[{"parameters":[{"name":"hasDictionaryDef","defaultValue":"true","description":"Only return words with dictionary definitions","required":false,"allowableValues":{"values":["false","true"],"valueType":"LIST"},"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"includePartOfSpeech","description":"CSV part-of-speech values to include","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":"excludePartOfSpeech","description":"CSV part-of-speech values to exclude","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":"minCorpusCount","description":"Minimum corpus frequency for terms","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"maxCorpusCount","description":"Maximum corpus frequency for terms","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"minDictionaryCount","description":"Minimum dictionary count","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"maxDictionaryCount","description":"Maximum dictionary count","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"minLength","description":"Minimum word length","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"maxLength","description":"Maximum word length","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns a single random WordObject","httpMethod":"GET","responseTypeInternal":"com.wordnik.corpus.entity.Word","errorResponses":[{"reason":"No word found.","code":404}],"nickname":"getRandomWord","responseClass":"wordObject"}]}],"apiVersion":"4.0","swaggerVersion":"1.1-SNAPSHOT","basePath":"http://api.wordnik.com/v4","models":{"WordSearchResults":{"properties":{"searchResults":{"type":"array","items":{"$ref":"WordSearchResult"}},"totalResults":{"type":"int"}},"id":"wordSearchResults"},"Example":{"properties":{"id":{"type":"long"},"title":{"type":"string"},"text":{"type":"string"},"url":{"type":"string"}},"id":"example"},"WordSearchResult":{"properties":{"count":{"type":"long"},"lexicality":{"type":"double"},"word":{"type":"string"}},"id":"WordSearchResult"},"WordFrequency":{"properties":{"count":{"type":"long"},"wordstring":{"type":"string"}},"id":"wordFrequency"},"WordOfTheDay":{"properties":{"id":{"type":"long","required":true},"parentId":{"type":"string"},"category":{"type":"string"},"createdBy":{"type":"string"},"createdAt":{"type":"Date"},"contentProvider":{"type":"contentProvider"},"htmlExtra":{"type":"string"},"word":{"type":"string"},"definitions":{"type":"array","items":{"$ref":"definition"}},"examples":{"type":"array","items":{"$ref":"example"}},"note":{"type":"string"},"publishDate":{"type":"Date"}},"id":"WordOfTheDay"},"ContentProvider":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"contentProvider"},"WordObject":{"properties":{"id":{"type":"long","required":true},"word":{"type":"string"},"vulgar":{"type":"string"}},"id":"wordObject"},"Definition":{"properties":{"com$wordnik$corpus$pos$traits$PartOfSpeech$$returnMode":{"type":"int"},"com$wordnik$corpus$pos$traits$PartOfSpeech$$posString":{"type":"string"},"text":{"type":"string"},"source":{"type":"string"},"com$wordnik$corpus$pos$traits$PartOfSpeech$$pos":{"type":"partOfSpeech"},"note":{"type":"string"},"partOfSpeechObj":{"type":"partOfSpeech"},"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"}}}