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 21 Aug 2026, 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

If Astroworld (Minecraft Data) does not fit, these game & anime apis cover similar ground. Every one was called before publishing, and each links to its own reference page with a working curl command and the response it returned.