{"resourcePath":"/words","apis":[{"path":"/words.{format}/search","description":"","operations":[{"parameters":[{"name":"allowRegex","defaultValue":"false","description":"Search term is a Regular Expression","required":false,"dataType":"string","allowableValues":{"values":["true","false"],"valueType":"LIST"},"paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"query","description":"Search term","required":true,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"caseSensitive","defaultValue":"true","description":"Search case sensitive","required":false,"dataType":"string","allowableValues":{"values":["true","false"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"includePartOfSpeech","description":"Only include these comma-delimited parts of speech","required":false,"dataType":"string","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"},"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,"dataType":"string","allowableValues":{"max":"Infinity","min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"maxCorpusCount","description":"Maximum corpus frequency for terms","required":false,"dataType":"string","allowableValues":{"max":"Infinity","min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"minDictionaryCount","defaultValue":"1","description":"Minimum number of dictionary entries for words returned","required":false,"dataType":"string","allowableValues":{"max":"Infinity","min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"maxDictionaryCount","description":"Maximum dictionary definition count","required":false,"dataType":"string","allowableValues":{"max":"Infinity","min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"minLength","defaultValue":"1","description":"Minimum word length","required":false,"dataType":"string","allowableValues":{"max":1024.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"maxLength","description":"Maximum word length","required":false,"dataType":"string","allowableValues":{"max":1024.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"minLexicalityRating","defaultValue":"0","description":"Minimum lexicality","required":false,"dataType":"string","allowableValues":{"max":100.0,"min":0.0,"valueType":"RANGE"},"paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"maxLexicalityRating","defaultValue":"0","description":"Maximum lexicality","required":false,"dataType":"string","allowableValues":{"max":100.0,"min":0.0,"valueType":"RANGE"},"paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"skip","defaultValue":"0","description":"Results to skip","required":false,"dataType":"string","allowableValues":{"max":1000.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"limit","defaultValue":"10","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":{"max":1000.0,"min":1.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"}],"summary":"Searches words.","responseTypeInternal":"com.wordnik.corpus.stats.entity.WordFrequency","errorResponses":[{"reason":"Invalid term supplied.","code":400},{"reason":"No results.","code":404}],"nickname":"searchWords","responseClass":"List[wordFrequency]","httpMethod":"GET"}]},{"path":"/words.{format}/wordOfTheDayList/{permalink}","description":"","operations":[{"parameters":[{"name":"permalink","description":"ID of WordOfTheDayList","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"includeAll","description":"Returns future WordOfTheDay items","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches a WordOfTheDayList by ID","responseTypeInternal":"com.wordnik.corpus.updated.entity.WordOfTheDayList","errorResponses":[{"reason":"Invalid id supplied","code":400},{"reason":"WordOfTheDayList not found","code":404}],"nickname":"getWordOfTheDayList","responseClass":"wordOfTheDayList","httpMethod":"GET"}]},{"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","responseTypeInternal":"com.wordnik.community.entity.WordOfTheDay","nickname":"getWordOfTheDay","responseClass":"WordOfTheDay","httpMethod":"GET"}]},{"path":"/words.{format}/searchEntries","description":"","operations":[{"parameters":[{"name":"query","description":"Search term","required":true,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"skip","defaultValue":"0","description":"Results to skip","required":false,"dataType":"string","allowableValues":{"max":1000.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"limit","defaultValue":"10","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":{"max":1000.0,"min":1.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"}],"summary":"Searches dictionary entries.","responseTypeInternal":"com.wordnik.index.entry.EntrySearchResults","errorResponses":[{"reason":"Invalid term supplied.","code":400}],"nickname":"searchEntries","responseClass":"EntrySearchResults","httpMethod":"GET"}]},{"path":"/words.{format}/searchDefinitions","description":"","operations":[{"parameters":[{"name":"query","description":"Search term","required":true,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"definedWordSearchTerm","description":"Defined word search term","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"includeSourceDictionaries","description":"Only include these comma-delimited source dictionaries","required":false,"dataType":"string","allowableValues":{"values":["ahd"," century"," wiktionary"," webster"," wordnet"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"excludeSourceDictionaries","description":"Exclude these comma-delimited source dictionaries","required":false,"dataType":"string","allowableValues":{"values":["ahd"," century"," wiktionary"," webster"," wordnet"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"includePartOfSpeech","description":"Only include these comma-delimited parts of speech","required":false,"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,"dataType":"string","allowableValues":{"max":"Infinity","min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"maxCorpusCount","description":"Maximum corpus frequency for terms","required":false,"dataType":"string","allowableValues":{"max":"Infinity","min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"minLength","defaultValue":"1","description":"Minimum word length","required":false,"dataType":"string","allowableValues":{"max":1024.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"maxLength","description":"Maximum word length","required":false,"dataType":"string","allowableValues":{"max":1024.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"expandTerms","description":"Expand terms","required":false,"dataType":"string","allowableValues":{"values":["synonym","hypernym"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"wordTypes","description":"Word types","required":false,"dataType":"string","allowableValues":{"values":["word","multi-word-unit"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"returnWordsOnly","defaultValue":"false","description":"Return words only","required":false,"dataType":"string","allowableValues":{"values":["false","true"],"valueType":"LIST"},"paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"includeTags","defaultValue":"false","description":"Return a closed set of XML tags in response","required":false,"dataType":"string","allowableValues":{"values":["false","true"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"useTagsForRanking","defaultValue":"true","description":"Use user tags, dictionary labels and hypernyms for ranking","required":false,"dataType":"string","allowableValues":{"values":["false","true"],"valueType":"LIST"},"paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"sortBy","description":"Attribute to sort by","required":false,"dataType":"string","allowableValues":{"values":["alpha","count","length"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"sortOrder","description":"Sort direction","required":false,"dataType":"string","allowableValues":{"values":["asc","desc"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"skip","defaultValue":"0","description":"Results to skip","required":false,"dataType":"string","allowableValues":{"max":1000.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"limit","defaultValue":"10","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":{"max":1000.0,"min":1.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"}],"summary":"Searches definitions.","responseTypeInternal":"com.wordnik.index.definition.DefinitionSearchResults","errorResponses":[{"reason":"Invalid term supplied.","code":400}],"nickname":"searchDefinitions","responseClass":"DefinitionSearchResults","httpMethod":"GET"}]},{"path":"/words.{format}/surfaceForms","description":"","operations":[{"parameters":[{"name":"term","description":"Word to get surface forms for.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches surface forms of a word","responseTypeInternal":"String","errorResponses":[{"reason":"Invalid term supplied.","code":400}],"nickname":"getSurfaceForms","responseClass":"String","httpMethod":"GET"}]},{"path":"/words.{format}/wordOfTheDay/range","description":"","operations":[{"parameters":[{"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"},{"name":"provider","description":"Filters response by ContentProvider","required":false,"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 a WordOfTheDay range","responseTypeInternal":"com.wordnik.community.entity.WordOfTheDay","nickname":"getWordOfTheDayRange","responseClass":"List[WordOfTheDay]","httpMethod":"GET"}]},{"path":"/words.{format}/canonicalForms","description":"","operations":[{"parameters":[{"name":"term","description":"Word to get canonical forms for.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches canonical forms of a word","responseTypeInternal":"String","errorResponses":[{"reason":"Invalid term supplied.","code":400}],"nickname":"getCanonicalForms","responseClass":"String","httpMethod":"GET"}]},{"path":"/words.{format}/search/{query}","description":"","operations":[{"parameters":[{"name":"allowRegex","defaultValue":"false","description":"Search query is a Regular Expression","required":false,"dataType":"string","allowableValues":{"values":["true","false"],"valueType":"LIST"},"paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"query","description":"Search query","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"caseSensitive","defaultValue":"true","description":"Search case sensitive","required":false,"dataType":"string","allowableValues":{"values":["true","false"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"includePartOfSpeech","description":"Only include these comma-delimited parts of speech","required":false,"dataType":"string","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"},"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,"dataType":"string","allowableValues":{"max":"Infinity","min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"maxCorpusCount","description":"Maximum corpus frequency for terms","required":false,"dataType":"string","allowableValues":{"max":"Infinity","min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"minDictionaryCount","defaultValue":"1","description":"Minimum number of dictionary entries","required":false,"dataType":"string","allowableValues":{"max":"Infinity","min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"maxDictionaryCount","description":"Maximum dictionary count","required":false,"dataType":"string","allowableValues":{"max":"Infinity","min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"minLength","defaultValue":"1","description":"Minimum word length","required":false,"dataType":"string","allowableValues":{"max":1024.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"maxLength","description":"Maximum word length","required":false,"dataType":"string","allowableValues":{"max":1024.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"minLexicalityRating","defaultValue":"0","description":"Minimum lexicality","required":false,"dataType":"string","allowableValues":{"max":100.0,"min":0.0,"valueType":"RANGE"},"paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"maxLexicalityRating","defaultValue":"0","description":"Maximum lexicality","required":false,"dataType":"string","allowableValues":{"max":100.0,"min":0.0,"valueType":"RANGE"},"paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"skip","defaultValue":"0","description":"Results to skip","required":false,"dataType":"string","allowableValues":{"max":1000.0,"min":0.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"},{"name":"limit","defaultValue":"10","description":"Maximum number of results to return","required":false,"dataType":"string","allowableValues":{"max":1000.0,"min":1.0,"valueType":"RANGE"},"allowMultiple":false,"paramType":"query"}],"summary":"Searches words.","responseTypeInternal":"com.wordnik.index.word.WordSearchResults","errorResponses":[{"reason":"Invalid query supplied.","code":400}],"nickname":"searchWordsNew","responseClass":"wordSearchResults","httpMethod":"GET"}]},{"path":"/words.{format}/randomWords","description":"","operations":[{"parameters":[{"name":"hasDictionaryDef","description":"Only return words with dictionary definitions","required":false,"dataType":"string","allowableValues":{"values":["false","true"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"includePartOfSpeech","description":"CSV part-of-speech values to include","required":false,"dataType":"string","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"},"allowMultiple":false,"paramType":"query"},{"name":"excludePartOfSpeech","description":"CSV part-of-speech values to exclude","required":false,"dataType":"string","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"},"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":"minLexicalityRating","description":"Minimum lexicality","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"maxLexicalityRating","description":"Maximum lexicality","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"sortBy","description":"Attribute to sort by","required":false,"dataType":"string","allowableValues":{"values":["alpha","count"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"sortOrder","description":"Sort direction","required":false,"dataType":"string","allowableValues":{"values":["asc","desc"],"valueType":"LIST"},"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","responseTypeInternal":"com.wordnik.corpus.entity.Word","errorResponses":[{"reason":"Invalid term supplied.","code":400},{"reason":"No results.","code":404}],"nickname":"getRandomWords","responseClass":"List[wordObject]","httpMethod":"GET"}]},{"path":"/words.{format}/randomWord","description":"","operations":[{"parameters":[{"name":"hasDictionaryDef","defaultValue":"true","description":"Only return words with dictionary definitions","required":false,"dataType":"string","allowableValues":{"values":["false","true"],"valueType":"LIST"},"allowMultiple":false,"paramType":"query"},{"name":"includePartOfSpeech","description":"CSV part-of-speech values to include","required":false,"dataType":"string","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"},"allowMultiple":false,"paramType":"query"},{"name":"excludePartOfSpeech","description":"CSV part-of-speech values to exclude","required":false,"dataType":"string","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"},"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"},{"name":"minLexicalityRating","description":"Minimum lexicality","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"},{"name":"maxLexicalityRating","description":"Maximum lexicality","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Returns a single random WordObject","responseTypeInternal":"com.wordnik.corpus.entity.Word","errorResponses":[{"reason":"No word found.","code":404}],"nickname":"getRandomWord","responseClass":"wordObject","httpMethod":"GET"}]},{"path":"/words.{format}/examples","description":"","operations":[{"parameters":[{"description":"Words to fetch examples for","required":false,"dataType":"Array[java.lang.String]","allowMultiple":false,"paramType":"body"},{"name":"limit","description":"Maximum number of results to return","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches examples for multiple words.","responseTypeInternal":"com.wordnik.corpus.model.Example","errorResponses":[{"reason":"Invalid words to search with.","code":400}],"nickname":"getExamplesForWords","responseClass":"List[example]","httpMethod":"POST"}]},{"path":"/words.{format}/mostCommentedOn","description":"","operations":[{"parameters":[{"name":"dayInterval","description":"Number of days to consider","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 words most commented on.","responseTypeInternal":"com.wordnik.community.model.CommentSummary","errorResponses":[{"reason":"Invalid time interval.","code":400}],"nickname":"getWordsMostCommentedOn","responseClass":"List[commentSummary]","notes":"Set the dayInterval to determine the time frame.","httpMethod":"GET"}]},{"path":"/words.{format}/firstUsed/{statsType}/{object}","description":"","operations":[{"parameters":[{"name":"statsType","description":"DocumentStatsType dimension to filter by","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"object","description":"Identifier of DocumentStatsType object","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"detailed","description":"Return detailed data","required":false,"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":"Fetches words most commented on.","responseTypeInternal":"com.wordnik.corpus.stats.entity.DetailedWordUsage","errorResponses":[{"reason":"Invalid time interval.","code":400}],"nickname":"getWordsMostCommentedOn","responseClass":"List[detailedWordUsage]","notes":"Set the dayInterval to determine the time frame.","httpMethod":"GET"}]},{"path":"/words.{format}/wordOfTheDayList/{permalink}/invite","description":"","operations":[{"parameters":[{"name":"permalink","description":"ID of WordOfTheDayList","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"description":"Invitation to send","required":false,"dataType":"wotdListInvitation","valueTypeInternal":"wotdListInvitation","allowMultiple":false,"paramType":"body"}],"summary":"Invites users to a WordOfTheDayList","responseTypeInternal":"ok","errorResponses":[{"reason":"User is not eligible to send invitations","code":400},{"reason":"WordOfTheDayList not found.","code":404}],"nickname":"inviteToWordOfTheDayList","responseClass":"ok","notes":"A user can invite up to 20 people in a single day. The users being invited will be checked to see if they have opted out of email communications","httpMethod":"POST"}]},{"path":"/words.{format}/wordOfTheDayLists/recent","description":"","operations":[{"parameters":[{"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":"Fetches recently created WordOfTheDayLists","responseTypeInternal":"com.wordnik.corpus.updated.entity.WordOfTheDayList","errorResponses":[{"reason":"No WordOfTheDayLists found.","code":404}],"nickname":"getRecentWordOfTheDayLists","responseClass":"List[wordOfTheDayList]","httpMethod":"GET"}]},{"path":"/words.{format}/wordOfTheDayList/{permalink}/{specifier}","description":"","operations":[{"parameters":[{"name":"permalink","description":"ID of WordOfTheDayList","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"specifier","description":"Specifier for the item to fetch.  Either 'current' or a date.","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"includeExtraHtml","description":"Include extra HTML if available","required":false,"dataType":"string","paramAccess":"internal","allowMultiple":false,"paramType":"query"}],"summary":"Fetches a WordOfTheDayList by ID","responseTypeInternal":"com.wordnik.community.entity.WordOfTheDay","errorResponses":[{"reason":"Invalid id supplied","code":400},{"reason":"WordOfTheDayList not found","code":404}],"nickname":"getWordOfTheDayListItem","responseClass":"WordOfTheDay","httpMethod":"GET"}]},{"path":"/words.{format}/wordOfTheDayLists","description":"","operations":[{"parameters":[{"name":"containsWord","description":"Lists must contain a specific word","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"subscriberCount","description":"Lists must have the specified number of subscribers","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"itemCount","description":"Lists must have the specified number of items","required":true,"dataType":"string","allowMultiple":false,"paramType":"query"},{"name":"includeAll","description":"Returns future WordOfTheDay items","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches an array of WordOfTheDayList basd on a criteria","responseTypeInternal":"com.wordnik.corpus.updated.entity.WordOfTheDayList","errorResponses":[{"reason":"Invalid word supplied.","code":400}],"nickname":"getWordOfTheDayListsContainingWord","responseClass":"List[wordOfTheDayList]","httpMethod":"GET"}]},{"path":"/words.{format}/wordOfTheDayLists/subscriptionProcess","description":"","operations":[{"parameters":[{"name":"date","description":"Date string to fetch for.","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Returns whether or not a subscription process has been run.","responseTypeInternal":"String","errorResponses":[{"reason":"Invalid date format supplied.","code":400}],"nickname":"getWordOfTheDayListSubscriptionProcessStatus","responseClass":"String","notes":"Uses the current server time (day resolution) as the default date to check for, optionally a dateString can be supplied for a specific date to check for.","httpMethod":"GET"}]},{"path":"/words.{format}/wordOfTheDayList/{permalink}/subscription","description":"","operations":[{"parameters":[{"name":"auth_token","description":"auth_token of logged-in user","required":true,"dataType":"string","allowMultiple":false,"paramType":"header"},{"name":"permalink","description":"ID of WordOfTheDayList","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"medium","description":"Medium to subscribe with","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"},{"description":"Username to subscribe","required":false,"dataType":"string","allowMultiple":false,"paramType":"body"}],"summary":"Subscribes a user to a WordOfTheDayList","responseTypeInternal":"ok","errorResponses":[{"reason":"Invalid ID supplied","code":400},{"reason":"Not authorized to subscribe","code":403},{"reason":"WordOfTheDayList or User not found","code":404}],"nickname":"subscribeToList","responseClass":"ok","httpMethod":"POST"}]},{"path":"/words.{format}/wordOfTheDayLists/{date}","description":"","operations":[{"parameters":[{"name":"date","description":"ID of WordOfTheDayList","required":true,"dataType":"string","allowMultiple":false,"paramType":"path"},{"name":"includeAll","description":"Returns future WordOfTheDay items","required":false,"dataType":"string","allowMultiple":false,"paramType":"query"}],"summary":"Fetches WordOfTheDay objects for a specific date","responseTypeInternal":"com.wordnik.community.entity.WordOfTheDay","errorResponses":[{"reason":"Invalid ID supplied","code":400},{"reason":"WordOfTheDayList or User not found","code":404}],"nickname":"getWordOfTheDayListsForDate","responseClass":"List[WordOfTheDay]","httpMethod":"GET"}]}],"models":{"SubscriptionStatus":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"SubscriptionStatus"},"DocumentMetadata":{"properties":{"tags":{"type":"array","items":{"type":"string"}},"yearType":{"type":"yearType"},"expirationDate":{"type":"Date"},"extendedMetadata":{"type":"extendedMetadata"},"stats":{"type":"basicDocumentStats"},"provider":{"type":"contentProvider"},"contentType":{"type":"contentType"},"sourceUrl":{"type":"string"},"date":{"type":"Date"},"medium":{"type":"documentMedium"},"guid":{"type":"string"},"id":{"type":"long"},"authors":{"type":"array","items":{"$ref":"author"}},"title":{"type":"string"},"primaryAuthorType":{"type":"authorType"},"createdAt":{"type":"Date"},"classification":{"type":"subjectClassificationType"},"year":{"type":"integer"},"primaryAuthor":{"type":"string"},"rating":{"type":"double"},"primaryAuthorId":{"type":"long"}},"id":"documentMetadata"},"WordOfTheDayList":{"properties":{"subscriberCount":{"type":"int"},"commentCount":{"type":"int"},"firstItemDate":{"type":"Date"},"voteCount":{"type":"integer"},"id":{"type":"string","required":true},"category":{"type":"string"},"createdBy":{"type":"string"},"items":{"type":"array","items":{"$ref":"WordOfTheDay"}},"description":{"type":"string"},"createdAt":{"type":"Date"},"name":{"type":"string"},"voteWeightedAverage":{"type":"float"},"subscriptionSchedule":{"type":"string"},"lastItemDate":{"type":"Date"},"voteAverage":{"type":"float"},"itemCount":{"type":"int"},"subscriptionStatus":{"type":"string"}},"id":"wordOfTheDayList"},"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"},"WordObject":{"properties":{"id":{"type":"long","required":true},"word":{"type":"string"},"vulgar":{"type":"string"}},"id":"wordObject"},"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"},"TextPron":{"properties":{"raw":{"type":"string"},"rawType":{"type":"string"}},"id":"textPron"},"WordSearchResult":{"properties":{"count":{"type":"long"},"lexicality":{"type":"double"},"word":{"type":"string"}},"id":"WordSearchResult"},"DetailedWordUsage":{"properties":{"sentence":{"type":"sentence"},"wordstring":{"type":"string"},"metadata":{"type":"documentMetadata"}},"id":"detailedWordUsage"},"EntrySearchResult":{"properties":{"sourceDictionary":{"type":"string"},"headWord":{"type":"string"},"definitions":{"type":"array","items":{"$ref":"definition"}},"entryId":{"type":"long"}},"id":"EntrySearchResult"},"Note":{"properties":{"appliesTo":{"type":"array","items":{"type":"string"}},"value":{"type":"string"}},"id":"note"},"DefinitionSearchResults":{"properties":{"results":{"type":"array","items":{"$ref":"definition"}},"totalResults":{"type":"int"}},"id":"DefinitionSearchResults"},"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"},"CommentSummary":{"properties":{"objectDisplayName":{"type":"string"},"totalCount":{"type":"long"},"objectName":{"type":"string"},"countInInterval":{"type":"long"},"intervalInMilliseconds":{"type":"long"},"objectType":{"type":"string"}},"id":"commentSummary"},"Category":{"properties":{"id":{"type":"long","required":true},"name":{"type":"string"}},"id":"category"},"WordFrequency":{"properties":{"count":{"type":"long"},"wordstring":{"type":"string"}},"id":"wordFrequency"},"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"},"EntrySearchResults":{"properties":{"searchResults":{"type":"array","items":{"$ref":"EntrySearchResult"}},"totalResults":{"type":"int"}},"id":"EntrySearchResults"},"ContentProvider":{"properties":{"id":{"type":"int"},"name":{"type":"string"}},"id":"contentProvider"},"Label":{"properties":{"text":{"type":"string"}},"id":"Label"},"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"}},"basePath":"http://api.wordnik.com/v4","swaggerVersion":"1.1-SNAPSHOT","apiVersion":"4.0"}