Gamepedia APIminecraft.gamepedia.com ↗
Retrieve complete Minecraft Bedrock achievements (with Gamerscore) and Java Edition advancements via two structured endpoints. Names, descriptions, and earning criteria included.
What is the Gamepedia API?
This API provides structured data from the Minecraft Wiki across 2 endpoints covering both major editions of the game. The get_achievements endpoint returns every Bedrock Edition achievement with its name, in-game description, earning requirements, and Gamerscore point value, while get_advancements covers the equivalent Java Edition advancement list. Each response includes a total_count field alongside the full item array.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/3d17d5f6-e207-40a9-9c1b-70f7e2907e86/get_achievements' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace minecraft-gamepedia-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Minecraft Wiki achievements and advancements — browse both editions."""
from parse_apis.minecraft_wiki_achievement_api import MinecraftWiki, Achievement, Advancement, NotFoundError
client = MinecraftWiki()
# List Bedrock Edition achievements (with Gamerscore points)
for achievement in client.achievements.list(limit=5):
print(achievement.name, achievement.point_value, achievement.description)
# List Java Edition advancements
for advancement in client.advancements.list(limit=5):
print(advancement.name, advancement.requirements)
# Drill into a single Bedrock achievement
top = client.achievements.list(limit=1).first()
if top:
try:
# Demonstrate typed error handling on a fetch attempt
detail = client.achievements.list(limit=1).first()
print(detail.name, detail.point_value, detail.requirements)
except NotFoundError as exc:
print(f"Achievement not found: {exc}")
print("exercised: achievements.list / advancements.list / typed field access")Retrieves the complete list of Minecraft Bedrock Edition achievements from the wiki. Each achievement includes its name, in-game description, detailed earning criteria (actual requirements beyond the description), and Gamerscore point value. Returns all achievements in a single response with no pagination. Bedrock achievements carry integer Gamerscore values; achievements without points return 0.
No input parameters required.
{
"type": "object",
"fields": {
"total_count": "integer total number of achievements returned",
"achievements": "array of achievement objects each containing name, description, requirements, and point_value"
},
"sample": {
"data": {
"total_count": 135,
"achievements": [
{
"name": "Awarded all trophies",
"description": "All trophies have been awarded.",
"point_value": 0,
"requirements": "Automatically obtained when the first 50 trophies have been obtained."
},
{
"name": "Music to my Ears",
"description": "Play a music disc in a Jukebox.",
"point_value": 0,
"requirements": "—"
},
{
"name": "Change of Sheets",
"description": "Dye your bed a different color.",
"point_value": 0,
"requirements": "—"
}
]
},
"status": "success"
}
}About the Gamepedia API
Endpoints and Response Shape
get_achievements takes no input parameters and returns a flat array of Bedrock Edition achievement objects under the achievements key. Each object includes name, description, requirements, and point_value — the last being the Gamerscore integer assigned to that achievement on Xbox and other Bedrock platforms. The total_count integer at the top level tells you how many achievements the response contains without counting the array manually.
get_advancements follows the same structure but targets Minecraft Java Edition. It returns an advancements array where each entry has name, description, and requirements. The point_value field is present in the schema but Java Edition advancements carry no Gamerscore, so that field reflects the absence of a points system in that edition. total_count works identically to the achievements endpoint.
Data Coverage and Limitations
Both endpoints return the full catalog in a single response — there are no pagination parameters, category filters, or edition-specific sub-filters exposed. If you need only advancements from a particular in-game tab (like Nether or The End), you would need to filter the returned array client-side on the requirements or name fields. Coverage reflects the Minecraft Wiki's documented achievement and advancement lists, which track the game's current release state.
The Gamepedia API is a managed, monitored endpoint for minecraft.gamepedia.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when minecraft.gamepedia.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official minecraft.gamepedia.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a Minecraft progress tracker that displays Bedrock Gamerscore totals by reading
point_valuefrom each achievement object - Generate a checklist app for Java Edition players by rendering
nameanddescriptionfields fromget_advancements - Compare Bedrock vs Java goal structures by diffing
requirementsfields across both endpoints - Populate a quiz game with Minecraft achievement trivia using
descriptionandrequirementsdata - Create a wiki-style reference page that lists all achievements grouped by Gamerscore tier using
point_value - Automate documentation for a Minecraft server plugin that tracks player advancement completion against the full list from
get_advancements
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does the Minecraft Wiki have an official developer API?+
point_value or requirements.What does `point_value` return for Java Edition advancements?+
get_advancements includes point_value in each advancement object, but Java Edition advancements do not carry Gamerscore. The field will reflect zero or null for all Java advancements. Gamerscore data is only meaningful in the get_achievements response for Bedrock Edition.Can I filter achievements or advancements by in-game category (e.g. Nether, The End)?+
name or requirements fields for category keywords. If you need server-side filtering, you can fork this API on Parse and revise it to add a query parameter.