Getting Started
Quick Start
Get up and running in under a minute. Fetch random words, generate puzzles, validate guesses, and look up definitions with just a few lines of code.
Choose your language
No SDK needed — use any HTTP client.
1
1. Get your API key
Generate a key in Developer Portal → API Keys. Copy it immediately — it's only shown once. Then either set it as an environment variable or pass it to the SDK:
Set environment variable (recommended)
export ANAGRAMA_API_KEY="ak_your_key_here"2
2. Fetch random words
Make your first API call. If you set the ANAGRAMA_API_KEY env var, the SDK picks it up automatically. Otherwise, pass it to the constructor.
bash
curl https://api.playanagrama.com/api/v1/words/random?count=3 \
-H "Authorization: Bearer ak_your_key_here"3
3. Parse the response
You'll get back an array of random words and the count.
JSON
{
"words": [
"crane",
"plume",
"spire"
],
"count": 3
}What's next?
- Generate puzzles — use the Puzzle API to create complete Anagrama puzzles with hints, letter pools, and alternate answers
- Validate words — check if a player's guess is a real word with Validate Word, works across 870+ languages
- Look up definitions — the Dictionary API provides multilingual definitions, etymology, synonyms, and more
- Try the CLI — anagrama-cli is open source and uses this exact API