API Documentation

Access comprehensive Minecraft data through our RESTful API. Get detailed information on items, mobs, and crafting recipes.

Quick Start

Get started with the Minecraft Data API in minutes

Base URL

https://api.mc.4mbl.net

Authentication

Include your API key in the request header:

x-api-key: YOUR_API_KEY

Rate Limits

1000 requests/hour per API key

API Endpoints

Get Item Details

Retrieve detailed information about a specific Minecraft item

GET/v1/item/minecraft:diamond_sword

Parameters

identifier - Item identifier (e.g., 'minecraft:diamond_sword' or 'diamond_sword')

Example Request

GET /v1/item/minecraft:diamond_sword

Example Response

{
  "identifier": "minecraft:diamond_sword",
  "name": "Diamond Sword",
  "snapshot": "1.21.4",
  "stable_release": "1.21",
  "is_tool": true,
  "is_weapon": true,
  "automation_level": "manual",
  "light_level_emitted": 0
}

Search Items

Search for items by name or identifier

GET/v1/items/search

Query Parameters

q - Search query (required)
limit - Maximum results (optional, max 100, default 50)

Example Request

GET /v1/items/search?q=diamond&limit=10

API Status

Check API health and available endpoints

GET/v1/status

Example Request

GET /v1/status

Error Codes

Common HTTP status codes and their meanings

200Success

400Bad Request - Invalid parameters

401Unauthorized - Invalid API key

404Not Found - Item not found

429Too Many Requests - Rate limit exceeded

500Internal Server Error

Need Help?

Get support and stay updated with the latest API changes

Report Issues Contact Support