Astroworld (Minecraft Data) API

Base URL

https://api.astroworldmc.com/api/v1

Authentication

No key or account. The response carries `x-ratelimit-limit`, `x-ratelimit-remaining` and `x-ratelimit-reset` headers so you can track your allowance precisely.

Rate limit

100 requests per minute per address on the free tier, confirmed by the `x-ratelimit-limit: 100` and `x-ratelimit-reset: 60` headers in our capture.

Pricing

Free.

CORS

Enabled — callable directly from browser JavaScript

Official docs

Read the docs

Every request below was executed against the live API on 2026-08-21, and the response shown is the real body it returned — not an illustration.

curl 'https://api.astroworldmc.com/api/v1/mobs?search=creeper'

const res = await fetch("https://api.astroworldmc.com/api/v1/mobs?search=creeper");
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();
console.log(data);

import requests

res = requests.get("https://api.astroworldmc.com/api/v1/mobs?search=creeper", timeout=20)
res.raise_for_status()
print(res.json())

{
  "success": true,
  "count": 1,
  "data": [
    {
      "name": "Creeper",
      "id": "creeper",
      "type": "hostile",
      "hp": 20,
      "damage": {
        "easy": 22,
        "normal": 43,
        "hard": 64
      },
      "xpDrop": {
        "min": 5,
        "max": 5
      },
      "spawnBiomes": [
        "All Overworld biomes"
      ],
      "spawnConditions": "Spawns at light level 0 on solid blocks in the Overworld.",
      "drops": [
        {
          "item": "Gunpowder",
          "count": {
            "min": 0,
            "max": 2
          },
          "chance": 100
        },
        {
          "item": "Music Disc",
          "count": {
            "min": 1,
            "max": 1
          },
          "chance": 100
        }
      ],
      "behavior": "Silently approaches players and detonates after a 1.5s fuse. Explosion destroys blocks. Charged creepers (struck by lightning) have double explosion power.",
      "weaknesses": [
        "Cats and ocelots (flees from them)",
        "Shields",
        "Knockback"
      ],
      "tameable": false,
      "tamingMethod": null,
      "breedable": false,
      "breedingItem": null,
      "versionAdded": "Classic 0.24_SURVIVAL_TEST",
      "category": "hostile",
      "notes": "Music Discs drop only when killed by a skeleton or stray arrow. Charged creepers kill another mob to drop its head. Iconic Minecraft mob created from a modeling error."
    }
  ]
}

successboolean

Application-level result flag, sitting alongside `count` and `data` in every response.

countinteger

Number of records in `data` for this response — not a total across the collection.

data[].idstring

Lowercase slug such as `creeper`. This is the path segment for a single-record fetch, not a numeric id.

data[].hpinteger

Health points. Present on mobs; other collections have their own field sets entirely.

data[].damageobject

Damage broken out as `easy`, `normal` and `hard` rather than a single number, because Minecraft scales it by difficulty.

data[].xpDropobject

`min` and `max` experience dropped. Equal values mean a fixed amount.

data[].dropsarray

Each entry has an `item`, a `count` object with `min` and `max`, and a `chance` percentage. Read `notes` before trusting a chance in isolation.

data[].tameable / breedableboolean

With `tamingMethod` and `breedingItem` alongside — both null when the flag is false.

data[].versionAddedstring

The Minecraft version that introduced the entity, including pre-release names such as `Classic 0.24_SURVIVAL_TEST`.

data[].notesstring

Free-text caveats that qualify the structured fields. Essential context for drop tables in particular.

• Build a Minecraft reference site without scraping the wiki
• Add a mob lookup command to a server's Discord bot
• Generate loot-table documentation for a modpack or server guide
• Populate a biome or structure explorer for a mapping tool
• Ship an in-game command reference with searchable syntax