The datamuse Reference Manual

Table of Contents

The datamuse Reference Manual

This is the datamuse Reference Manual, version 1.1, generated automatically by Declt version 3.0 "Montgomery Scott" on Sun May 15 04:36:19 2022 GMT+0.

1 Introduction

#+TITLE: datamuse

A Common Lisp library wrapping version 1.1 of the [[https://www.datamuse.com/api/][Datamuse API]].

From the Datamuse site:

#+BEGIN_QUOTE
The Datamuse API is a word-finding query engine for developers. You can use it in your apps to find words that match a given set of constraints and that are likely in a given context. You can specify a wide variety of constraints on meaning, spelling, sound, and vocabulary in your queries, in any combination.

The API gives you programmatic access to most of the functionality of Datamuse's websites, including OneLook, RhymeZone, Rimar.io, and WikSearch.
#+END_QUOTE

Datamuse very generously allows up to 100,000 queries per day without an API key. Thus no setup is needed for this library. Just ~quickload~ it and go! :)

* Exported symbols

- function ~words~ - Get a list of words matching a query

- function ~words*~ - Get a list of words and their metadata matching a query

- function ~suggestions~ - Get a list of suggestions to a query string

- function ~suggestions*~ - Get a list of suggestions to a query string and their metadata

- function ~parameter-documentation~ - Get the documentation string for the specified parameter to ~words~ / ~words*~.

- symbol ~+words-query-parameters+~ - Alist mapping ~words~ and ~words*~ parameter names to the equivalent parameter name in Datamuse's API

Please see the docstrings for each symbol, the ~parameter-documentation~ function, and the [[http://www.datamuse.com/api/][Datamuse API documentation]] for more information.

* Similar libraries

- [[https://github.com/phoe/wordnet][wordnet]]

2 Systems

The main system appears first, followed by any subsystem dependency.

2.1 datamuse

Author

modula t.

Contact

defaultxr at gmail dot com

Home Page

https://github.com/defaultxr/datamuse

Source Control

(:git "git@github.com:defaultxr/datamuse.git")

Bug Tracker

https://github.com/defaultxr/datamuse/issues

License

MIT

Description

Common Lisp library for accessing the Datamuse word-finding API

Version

1.1

Dependencies

• alexandria
• drakma
• yason

Source

datamuse.asd (file)

Components

• package.lisp (file)
• datamuse.lisp (file)

3 Files

Files are sorted by type and then listed depth-first from the systems components trees.

3.1 Lisp

3.1.1 datamuse.asd

Location

datamuse.asd

Systems

datamuse (system)

3.1.2 datamuse/package.lisp

Parent

datamuse (system)

Location

package.lisp

Packages

datamuse

3.1.3 datamuse/datamuse.lisp

Dependency

package.lisp (file)

Parent

datamuse (system)

Location

datamuse.lisp

Exported Definitions

• +words-query-parameters+ (constant)
• parameter-documentation (function)
• suggestions (function)
• suggestions* (function)
• words (function)
• words* (function)

4 Packages

Packages are listed by definition order.

4.1 datamuse

Source

package.lisp (file)

Use List

• alexandria
• common-lisp

Exported Definitions

• +words-query-parameters+ (constant)
• parameter-documentation (function)
• suggestions (function)
• suggestions* (function)
• words (function)
• words* (function)

5 Definitions

Definitions are sorted by export status, category, package, and then by lexicographic order.

5.1 Exported definitions

5.1.1 Constants

Constant: +words-query-parameters+

Alist mapping ‘words’ and ‘words*’ parameter names to the API’s query parameter names and the official documentation for each. You can also use the ‘parameter-documentation’ function to easily get the documentation for a specific parameter.

See https://www.datamuse.com/api/ for more information about the API.

See also: ‘parameter-documentation’, ‘words’, ‘words*’

Package

datamuse

Source

datamuse.lisp (file)

5.1.2 Functions

Function: parameter-documentation PARAMETER

Get the documentation string for the specified parameter of the ‘words’ function.

See also: ‘+words-query-parameters+’, ‘words’, ‘words*’

Package

datamuse

Source

datamuse.lisp (file)

Function: suggestions STRING &key MAX VOCABULARY

Get a list of suggestions to a partially-type phrase, similar to the auto-suggest feature of some search engines. This function works by querying the Datamuse API’s /sug endpoint as described at https://www.datamuse.com/api/ .

STRING is the input string to generate suggestions for, MAX is the maximum number of results, VOCABULARY is the vocabulary (which defaults to English).

Examples:

;; (dm:suggestions "rei")
=> ("rein" "reiterate" "reign" "reinforce" "reimbursement" "reimburse" "reinstate" "reify" "reins" "reiki")

See also: ‘words’, ‘suggestions*’.

Package

datamuse

Source

datamuse.lisp (file)

Function: suggestions* STRING &key MAX VOCABULARY

Performs a query to the Datamuse API’s /sug endpoint as described at https://www.datamuse.com/api/ , to get a list of suggestions to partially-typed queries, similar to the auto-suggest feature of some search engines.

STRING is the input string to generate suggestions for, MAX is the maximum number of results, VOCABULARY is the vocabulary (which defaults to English).

See also: ‘suggestions’, ‘words’.

Package

datamuse

Source

datamuse.lisp (file)

Function: words &rest PARAMETERS

Get a list of words matching the query specified. See the ‘+words-query-parameters+’ alist or the ‘parameter-documentation’ function for documentation on each parameter. This function works by performing a query to the Datamuse API’s /words endpoint as described at https://www.datamuse.com/api/ .

Note that this function returns just a list of words. To get the full results which include the metadata, use ‘words*’.

Examples:

;; Get a list of words that rhyme with "foobar":
;; (words :rhymes "foobar")

;; Get a list of words that start with "s" and end with "ing":
;; (words :spelling "s*ing")

See also: ‘words*’, ‘parameter-documentation’, ‘+words-query-parameters+’, ‘suggestions’.

Package

datamuse

Source

datamuse.lisp (file)

Function: words* &rest PARAMETERS

Get a list of results matching the query specified, including the metadata for each. See the ‘+words-query-parameters+’ alist or the ‘parameter-documentation’ function for documentation on each parameter. This function works by performing a query to the Datamuse API’s /words endpoint as described at https://www.datamuse.com/api/ .

Note that the with-* parameters are simply boolean toggles that set whether specific metadata is included in the results; they don’t actually change which results are returned.

This function includes all of the data returned by the API as alists (i.e. including various metadata for each result). If you just want a list of the words themselves, use ‘words’.

See also: ‘words’, ‘parameter-documentation’, ‘+words-query-parameters+’, ‘suggestions’.

Package

datamuse

Source

datamuse.lisp (file)

Appendix A Indexes

A.1 Concepts

A.2 Functions

A.3 Variables

A.4 Data types