API documentation
Read-only JSON under /api/v1. CORS is open for GET. Machine-readable schema: /api/v1/openapi.json.
GET /api/v1/maps
Query params: q, category, author, tag, limit (1–100), cursor. Soft-removed maps are excluded.
curl "/api/v1/maps?category=Parkour&limit=25"
GET /api/v1/maps/{sourceIdOrSlug}
Full record plus rehosted images[].url pointing at this host. download_url remains on minecraftmaps.com.
curl "/api/v1/maps/ultimate-rage-parkour"
GET /api/v1/stats · /api/v1/categories · /api/v1/images/{id}
Dataset health (including whether image storage is s3 or local), category counts, and rehosted preview images. Images are Sharp-optimized to WebP; with S3 configured, this route redirects to the bucket/CDN URL.
POST /api/v1/removals
Creator takedown requests. Body: email, reason, and mapUrl or sourceId.
curl -X POST /api/v1/removals \
-H "content-type: application/json" \
-d '{"email":"you@example.com","sourceId":53008,"reason":"Please remove my map from the open mirror."}'