Get started
Just call any endpoint
Anonymous access works. 600 tokens/min - enough for exploration.
GET https://z87.ai/api/jokes/random
→ works immediately
Get a key for 6,000 tokens/min
Keys last a year.
GET https://z87.ai/api/use
→ {"key": "0001922f3a..."}
X-Api-Key: 0001922f3a...
Wait a second, retry
Budget refills at 100 tokens/sec. Burst up to 6,000 then sustain.
Get a new key
Just call /api/use again.
Freeforever
| Dataset | Scale | Highlights | Try | Docs |
|---|---|---|---|---|
| Chess | 1B+ games, 2.4M players | Position trie, game filters, head-to-head, openings | /api/chess/position?moves=e4 e5 Nf3 | SKILL.MD |
| Countries | 247 nations, 282 indicators | 60yr timeseries, rank, correlate, histogram, growth | /api/countries/rank?indicator=gdp_per_capita_usd | SKILL.MD |
| Food | 13.5K recipes, 8K ingredients, 2M products | 45+ filters (taste, texture, diet), pairings, barcode lookup | /api/food/recipes/filter?cuisine=italian | SKILL.MD |
| GBIF | 7.7M taxa | Tree of life, synonym resolution, lineage, descendants | /api/gbif/search?q=canis lupus | SKILL.MD |
| Gutenberg | 60K books, 1.2M illustrations | AI tags (genre, mood, era, locations), cover art, filter by rating/era/genre | /api/gutenberg/books?q=pride prejudice | SKILL.MD |
| Home | 11K+ devices, 3 protocols | Structured capabilities, commands with exact payloads, compatible platforms | /api/home/search?q=motion sensor | SKILL.MD |
| Jokes | 41K jokes, 16 categories | BM25 search, category/rating/offensive filters | /api/jokes/random | SKILL.MD |
| MTG | 29K cards, 138K combos | Synergy engine, combo detection, Commander deck builder | /api/mtg/cards/search?q=lightning bolt | SKILL.MD |
| Music | 651K artists, 1.6M albums, 4.1M songs | CF on 1.5B listens, 4 modes (similar/opposite/explore/like-dislike), 4 pools (popular/known/deep/obscure) | /api/music/artists/search?q=radiohead | SKILL.MD |
| OSM | 46M+ places | Hilbert spatial index, text+geo combined search | /api/osm/search?q=starbucks&lat=48.85&lon=2.35 | SKILL.MD |
| Wikipedia | 7.2M articles, 1.3M geo-tagged | Summary + infobox, full markdown, link graph, geo search | /api/wikipedia/summary/Albert_Einstein | SKILL.MD |
| Wiktionary | 8M+ entries, 4K+ languages | IPA, etymology, translations, synonyms, definitions | /api/wiktionary/word/hello | SKILL.MD |
Full machine-readable docs: z87.ai/api/SKILL.md
Chess
SKILL.MD+
1B+ rated Lichess games (2000+ Elo, 2013–2026). Position trie, game filters, head-to-head.
Endpoints
GET /api/chess/position?moves=e4%20e5%20Nf3&limit=1
{
"games": [
{
"black": "Ukraine-team-creator",
"black_elo": 3111,
"eco": "C40",
"game_id": 155475799400,
"opening": "King's Knight Opening",
"ply_count": 3,
"result": "1-0",
"white": "MayhemPI_cluster",
"white_elo": 3220
}
],
"limit": 1,
"offset": 0,
"total": 66486348
}Countries
SKILL.MD+
247 countries, 282 indicators (57 static, 225 timeseries) across economics, health, demographics, energy, environment, education. World Bank, WHO, UNDP.
Endpoints
GET /api/countries/rank?indicator=gdp_per_capita_usd&limit=1
{
"entries": [
{
"country": "Monaco",
"iso3": "MCO",
"rank": 1,
"value": 256580.515122745
}
],
"indicator": "gdp_per_capita_usd",
"limit": 1,
"offset": 0,
"total": 223
}Food
SKILL.MD+
13.5K recipes with taste/texture profiles and 45+ filter params. 8K+ USDA FDC ingredients with portion sizes. 2M products with Nutri-Score, NOVA ratings, and barcode lookup.
Recipe Endpoints
GET /api/food/recipes/filter?cuisine=italian&is_vegetarian=true&limit=1
{
"limit": 1,
"offset": 0,
"recipes": [
{
"cuisine": "italian",
"difficulty": "easy",
"id": 70,
"is_vegetarian": true,
"taste_profile": { "umami": 7, "fat": 7, "salty": 6, "sour": 4 },
"title": "Swiss Chard Pasta With Toasted Hazelnuts and Parmesan",
"total_time_minutes": 40
}
],
"total": 815
}Ingredient Endpoints
Product Endpoints
GBIF
SKILL.MD+
GBIF Backbone Taxonomy: 7.7M taxa with full hierarchy, synonym resolution, tree navigation, and full-text search across the tree of life.
Endpoints
GET /api/gbif/search?q=canis%20lupus&limit=1
{
"limit": 1,
"offset": 0,
"taxa": [
{
"canonical_name": "Canis lupus lupus",
"id": 7193871,
"kingdom": "Animalia",
"rank": "subspecies",
"status": "accepted"
}
],
"total": 44
}Gutenberg
SKILL.MD+
60,000 Project Gutenberg books with cover art, 1.2M illustrations, and AI-generated tags: genre, mood, era, locations, comparable books, five-word summaries, and read-at ages.
Endpoints
GET /api/gutenberg/books?q=pride+prejudice&limit=1
{
"books": [
{
"id": 1342,
"title": "Pride and Prejudice",
"author": "Jane Austen",
"genre": ["fiction", "romance"],
"mood": ["romantic", "humorous"],
"rating": 5,
"importance": 5,
"era": "romantic",
"five_words": "Witty woman outwits her prejudice"
}
],
"total": 3
}Home
SKILL.MD+
11K+ smart home devices from Z2M, Z-Wave JS, Tasmota, ESPHome. Structured capabilities with exact command payloads and state descriptions.
Endpoints
GET /api/home/search?q=motion+sensor&limit=1
{
"products": [
{
"id": 5681,
"name": "IWATSU Motion Sensor",
"vendor": "IWATSU",
"model": "Motion Sensor",
"category": "sensor",
"protocols": ["zwave"]
}
],
"total": 262
}Jokes
SKILL.MD+
41,000 jokes from three sources, AI-tagged with category, rating, topics, and offensive score.
Endpoints
GET /api/jokes/random
{
"joke": {
"body": "What's Canada's spy agency?\nThe CI, eh?",
"category": "wordplay",
"id": 16672,
"offensive_score": 0,
"rating": "clean",
"title": "What's Canada's spy agency?",
"topics": ["canada"]
}
}MTG
SKILL.MD+
29K Magic: The Gathering cards with synergy graph engine, combo detection, and Commander deck builder.
Endpoints
GET /api/mtg/cards/search?q=lightning%20bolt&limit=1
{
"cards": [
{
"cmc": 1.0,
"id": 14351,
"mana_cost": "{R}",
"name": "Lightning Bolt",
"rarity": "Common",
"type_line": "Instant"
}
],
"limit": 1,
"offset": 0,
"total": 1
}Music
SKILL.MD+
651K artists, 1.6M albums, 4.1M songs from MusicBrainz + ListenBrainz. Collaborative filtering on 1.5B real listens. Four modes (similar, opposite, explore, like/dislike) and four discovery pools (popular, known, deep, obscure).
Endpoints
GET /api/music/artists/search?q=radiohead&limit=1
{
"artists": [
{
"country": "GB",
"genres": ["alternative rock", "art rock", "electronic", "experimental"],
"id": 46,
"listen_count": 5711195,
"listener_count": 21322,
"name": "Radiohead",
"type": "Group"
}
],
"limit": 1,
"offset": 0,
"total": 1
}GET /api/music/suggest?artists=46,1,45&limit=3
{"like": ["Radiohead", "Massive Attack", "Portishead"],
"suggestions": [
{"name": "Pixies", "score": 0.999},
{"name": "Moby", "score": 0.999},
{"name": "Blur", "score": 0.999}],
"type": "artists", "mode": "similar", "pool": "popular"}
# modes: similar (default), opposite, explore
GET /api/music/suggest?artists=46,1&mode=opposite&limit=5
# like/dislike — refine with negative signal
GET /api/music/suggest?like=46,1&dislike=40&limit=5
# explore — orthogonal to both likes and dislikes
GET /api/music/suggest?like=46,1&dislike=40&mode=explore&limit=5
# discovery pools: popular (default), known, deep, obscure
GET /api/music/suggest?artists=46,1&pool=deep&limit=5
GET /api/music/suggest?songs=500,600&pool=obscure&limit=5OSM
SKILL.MD+
46M+ OpenStreetMap POIs with Hilbert-curve spatial index and BM25 text search.
Endpoints
GET /api/osm/search?q=starbucks&lat=48.8566&lon=2.3522&radius_km=5&limit=2
{
"elements": [
{
"category": "amenity",
"id": 3438053662,
"lat": 48.87618,
"lon": 2.3445282,
"name": "Starbucks"
}
],
"limit": 2,
"offset": 0,
"total": 43
}Wikipedia
SKILL.MD+
7.2M English Wikipedia articles with full markdown content, infoboxes, inter-article links, and geographic coordinates.
Endpoints
GET /api/wikipedia/summary/Albert_Einstein
{
"infobox": {
"Awards": "Nobel Prize in Physics (1921)...",
"Born": "14 March 1879, Ulm, Germany",
"Fields": "Physics",
"Known for": "General relativity, E=mc²..."
},
"link_count": 1096,
"summary": "Albert Einstein (14 March 1879 – 18 April 1955) was a German-born theoretical physicist...",
"title": "Albert Einstein",
"url": "Albert_Einstein"
}Wiktionary
SKILL.MD+
8M+ Wiktionary entries across 4,000+ languages with definitions, IPA, etymology, translations, and synonyms.
Endpoints
GET /api/wiktionary/word/hello
{
"entry": {
"languages": [
{
"language": "English",
"pronunciations": ["/hɛˈloʊ/"],
"senses": [
{ "definitions": ["A greeting..."], "pos": "interjection" },
{ "definitions": ["\"Hello!\" or an equivalent greeting."], "pos": "noun" }
],
"synonyms": ["hi", "howdy", "g'day"]
}
],
"word": "hello"
}
}Paidper query
Law
Coming soonChemistry
Coming soonWeather
Coming soonTerms of Use
z87 is free for any use by humans or agents. You may query the API from your own tools, scripts, and agents without restriction.
All data is provided as-is, with no warranty of any kind. We are not responsible for accuracy, completeness, availability, or fitness for any purpose. Do not rely on this data for medical, legal, financial, or safety-critical decisions.
We reserve the right to revoke access to any user or key at any time, for any reason, without notice.
By using the API you agree to these terms and to the upstream licenses of each dataset listed below.
Licenses
The z87 API code is MIT licensed. Each dataset carries its upstream license:
- chess - Lichess game data is CC0 1.0 (public domain).
- countries - World Bank data is CC BY 4.0. Additional sources: WHO, UNDP, CIA World Factbook (public domain). Attribution required for World Bank data.
- food - USDA FoodData Central is CC0/public domain. Open Food Facts product data is ODbL 1.0 (attribution and share-alike required). Recipes are original compilations under MIT. Nutritional data is informational only.
- gbif - GBIF Backbone Taxonomy is CC BY 4.0. Cite: GBIF Secretariat, GBIF Backbone Taxonomy, doi:10.15468/39omei.
- gutenberg - Project Gutenberg texts are public domain in the United States. Verify public domain status in your jurisdiction before redistribution.
- jokes - Collected from public domain sources. Content may be offensive. Offensive scores are machine-generated approximations.
- mtg - Card data from Scryfall under Wizards of the Coast Fan Content Policy. Magic: The Gathering is a trademark of Wizards of the Coast/Hasbro. Not affiliated with or endorsed by WotC.
- osm - OpenStreetMap data is ODbL 1.0. © OpenStreetMap contributors. Attribution and share-alike required.
- wikipedia - Wikipedia content is CC BY-SA 4.0. Attribution and share-alike required.
- wiktionary - Wiktionary content is CC BY-SA 4.0. Attribution and share-alike required.
Privacy
We log IP addresses for rate limiting. We do not use cookies, tracking pixels, or third-party analytics. We do not sell or share any data about API usage. That is the entire privacy policy.