Datamuse Words API

Query the official Datamuse API for rhymes, synonyms, antonyms, and semantically-related words for any input word(s). Each result is returned with a match score and numSyllables. Completely keyless and free — no API key, token, or paid tier required.

Input

|| Field | Type | Required | Default | Description | ||---|---|---|---|---| || words | array[string] | yes | — | List of input words to look up (e.g. ["hello"]). | || relationship | string | no | rel_rhy | Word relationship to query: rel_rhy (rhymes), rel_syn (synonyms), rel_ant (antonyms), rel_bga (words that often follow), or rel_trg (related/triggered by). | || max | integer | no | 1000 | Maximum results per word (Datamuse caps at 1000). |

Find rhymes for a word:

{"words": ["hello"], "relationship": "rel_rhy"}

Find synonyms for several words:

{
  "words": ["hello", "world"],
  "relationship": "rel_syn",
  "max": 100
}

Output

One dataset item per input word containing: word, inputWord, relationship, count, matches[] (each with word, score, numSyllables), and sourceUrl. Empty results are emitted as a record with count: 0 and no error (a valid no-match response). Each input word is one $0.001 pay-per-event charge (word-searched event).

Usage

cd datamuse-words
python3 -m venv .venv
. .venv/bin/activate
pip install -r requirements.txt
echo '{"words": ["hello"], "relationship": "rel_rhy"}' > storage/key_value_stores/default/INPUT.json
python src/main.py

Pricing

PAY_PER_EVENT — $0.001 per word-searched event (one per input word queried).

Related actors

• Free Dictionary API — word definitions, phonetics, pronunciation audio, and examples
• OpenAlex Paper Search — scholarly works, citations, authors, and topics
• Hacker News Story Stats — Hacker News front page and search stats via the Algolia API