Lexidata API Reference

Fetch detailed senses, grammatical parts of speech, IPA phonetic transcriptions, and usage examples.

import { createClient } from "lexidata";

const client = createClient();

async function getWordDetails(term) {
  try {
    const entry = await client.word(term);
    console.log(`Word: ${entry.word}`);

    if (entry.pronunciations?.length) {
      console.log(`IPA: ${entry.pronunciations.map(p => p.ipa).join(", ")}`);
    }

    entry.senses.forEach((sense, index) => {
      console.log(`[${index + 1}] (${sense.partOfSpeech}) ${sense.definition}`);
      sense.examples?.forEach(ex => console.log(`    e.g. "${ex}"`));
    });
  } catch (err) {
    if (err.statusCode === 404) {
      console.error(`Word "${term}" not found in dictionary.`);
    }
  }
}

getWordDetails("serendipity");

Implement instant prefix-based search for dropdowns, searchbars, or input suggest widgets.

import { createClient } from "lexidata";

const client = createClient();

async function autocompleteWord(prefix) {
  const results = await client
    .query()
    .startsWith(prefix)
    .limit(8);

  return results.data.map(item => ({
    word: item.word,
    pos: item.senses?.[0]?.partOfSpeech || "noun",
    snippet: item.senses?.[0]?.definition || "",
  }));
}

// Example usage:
const suggestions = await autocompleteWord("neur");
console.log(suggestions);

Filter words by character length, grammatical classification, prefix, or suffix for puzzles and word games.

import { createClient } from "lexidata";

const client = createClient();

// Query 5-letter adjectives starting with 'a'
async function findGameWords() {
  const matches = await client
    .query()
    .startsWith("a")
    .partOfSpeech("adjective")
    .minLength(5)
    .maxLength(5)
    .limit(10);

  console.log(matches.data.map(w => w.word));
}

findGameWords();

Fetch random words or structured definitions in Python for flashcards, daily notifications, or NLP training pipelines.

import requests

def get_daily_vocabulary(count=5, pos="adjective"):
    url = "https://api.lexidata.dev/api/v1/random"
    params = {"limit": count, "pos": pos}

    response = requests.get(url, params=params)
    response.raise_for_status()

    words = response.json()["data"]
    for item in words:
        word = item["word"]
        definition = item["senses"][0]["definition"] if item["senses"] else "N/A"
        print(f"✨ {word.upper()}: {definition}")

if __name__ == "__main__":
    get_daily_vocabulary()