Skip to main content

ASTROWORLD API

Free, public Minecraft data API. JSON responses, CORS enabled, no auth required.

v1.0Java 1.21JSON

Base URL: https://api.astroworldmc.com

76
Mobs
64
Biomes
100
Items
40
Enchantments
24
Structures
57
Commands
36
Versions
111
Achievements
13
Trades

Endpoints

GET
/api/v1/mobs?search=&type=&category=

All 76 Minecraft mobs with stats, drops, behavior

GET
/api/v1/mobs/:id

Single mob by ID or name slug

GET
/api/v1/biomes?search=&dimension=&category=&rarity=

All 64 biomes with terrain, colors, spawns

GET
/api/v1/biomes/:name

Single biome by ID or name slug

GET
/api/v1/items?search=&category=

100 items with crafting recipes, stats, enchantments

GET
/api/v1/items/:id

Single item by ID or name slug

GET
/api/v1/enchantments?search=&category=

40 enchantments with levels, compatibility, effects

GET
/api/v1/enchantments/:id

Single enchantment by ID or name slug

GET
/api/v1/structures?search=&dimension=&category=&rarity=

24 structures with loot tables, locations, dangers

GET
/api/v1/structures/:id

Single structure by ID or name slug

GET
/api/v1/commands?search=&category=&permissionLevel=

57 commands with syntax, params, examples

GET
/api/v1/commands/:name

Single command by name

GET
/api/v1/versions?search=&type=&edition=

36 version entries with features and changelogs

GET
/api/v1/versions/:slug

Single version by slug (e.g. 1-21)

GET
/api/v1/achievements?search=&tab=&difficulty=

111 advancements with tabs, difficulty, rewards

GET
/api/v1/achievements/:slug

Single achievement by slug

GET
/api/v1/trades?search=

All villager professions with full trade tables

GET
/api/v1/trades/:id

Single profession trade data by ID

GET
/api/health

API health check

Pretty Print

Add ?pretty=true to any endpoint for formatted JSON output.

Quick Start

JavaScript

const res = await fetch("https://api.astroworldmc.com/api/v1/mobs?search=creeper");
const data = await res.json();
console.log(data.data[0].name); // "Creeper"

Python

import requests

res = requests.get("https://api.astroworldmc.com/api/v1/mobs/creeper")
mob = res.json()["data"]
print(mob["name"])  # Creeper

curl

curl -s https://api.astroworldmc.com/api/v1/biomes?dimension=nether | jq '.data[].name'

Rate Limits

TierLimitWindow
Free100 requestsper minute per IP

Rate limit headers are included in every response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

Response Format

Success (200)

{
  "success": true,
  "count": 76,
  "data": [...]
}

Error (404)

{
  "success": false,
  "error": "Mob not found"
}

Attribution

The free tier requires a visible dofollow link on any page that uses this API:

<a href="https://api.astroworldmc.com">Powered by Astroworld API</a>