API Documentation

Returns the complete word object: definition, IPA, etymology, translations, age tones, and audio URL.

# Look up a word
curl -H "Authorization: Bearer wo_YOUR_KEY" \
  https://word-orb-api.nicoletterankin.workers.dev/api/word/courage

// JavaScript (fetch)
const res = await fetch("https://word-orb-api.nicoletterankin.workers.dev/api/word/courage", {
  headers: { "Authorization": "Bearer wo_YOUR_KEY" }
});
const word = await res.json();
console.log(word.def);    // definition
console.log(word.langs);  // 47 language translations

# Python (requests)
import requests

r = requests.get("https://word-orb-api.nicoletterankin.workers.dev/api/word/courage",
    headers={"Authorization": "Bearer wo_YOUR_KEY"})
word = r.json()
print(word["def"])    # definition
print(word["langs"])  # translations dict

Response fields:

Returns every word in the dictionary with IPA, part of speech, and lookup count.

curl -H "Authorization: Bearer wo_YOUR_KEY" https://word-orb-api.nicoletterankin.workers.dev/api/words

Look up multiple words in one request. Returns all found words and lists any that were not found. Free tier: max 10 words. Paid tiers: max 50 words.

# Batch lookup
curl -X POST -H "Authorization: Bearer wo_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"words":["courage","wisdom","resilience"]}' \
  https://word-orb-api.nicoletterankin.workers.dev/api/words/batch

Response: { requested, found, not_found, words: [...], errors: [...] }

Returns a structured 5-phase lesson: hook, story, wonder, action, wisdom.

curl -H "Authorization: Bearer wo_YOUR_KEY" \
  "https://word-orb-api.nicoletterankin.workers.dev/api/lesson?day=47&track=learn&age=adult&archetype=explorer"

const res = await fetch(
  "https://word-orb-api.nicoletterankin.workers.dev/api/lesson?day=47&track=learn&age=adult&archetype=explorer",
  { headers: { "Authorization": "Bearer wo_YOUR_KEY" } }
);
const lesson = await res.json();
console.log(lesson.phases.hook);    // opening hook
console.log(lesson.phases.wisdom);  // closing wisdom

r = requests.get("https://word-orb-api.nicoletterankin.workers.dev/api/lesson",
    params={"day": 47, "track": "learn", "archetype": "explorer"},
    headers={"Authorization": "Bearer wo_YOUR_KEY"})
lesson = r.json()
# lesson["phases"]["hook"], ["story"], ["wonder"], ["action"], ["wisdom"]

Response fields:

List all lessons for a given track, with pagination.

Returns all tracks, phases, age groups, archetypes, and lesson counts. No auth required.

Returns all 10 teaching archetypes with style descriptions. No auth required.

Returns all assessment questions for a specific day and track, aligned to the lesson content.

curl -H "Authorization: Bearer wo_YOUR_KEY" \
  "https://word-orb-api.nicoletterankin.workers.dev/api/quiz?day=47&track=learn"

Response fields (each interaction):

Returns random assessment questions from any day.

Returns batch of questions with difficulty filtering.

Find all lessons that teach a specific word.

curl -H "Authorization: Bearer wo_YOUR_KEY" \
  "https://word-orb-api.nicoletterankin.workers.dev/api/graph/word?word=courage"

# Returns: { word, appears_in: 15, lessons: [{ day, track, phase, context, importance }...] }

Find all vocabulary words that appear in a specific lesson.

Returns your current tier, daily usage, and remaining calls.

curl -H "Authorization: Bearer wo_YOUR_KEY" https://word-orb-api.nicoletterankin.workers.dev/api/keys/me

# Returns: { key, email, tier, daily_limit, calls_today, calls_total, remaining_today }

Create a free API key. Returns immediately with the key and quickstart examples.

curl -X POST -H "Content-Type: application/json" \
  -d '{"email":"you@company.com"}' \
  https://word-orb-api.nicoletterankin.workers.dev/api/signup