Hyrule Compendium API
An API serving data on all creatures, monsters, materials, equipment, and treasure in The Legend of Zelda: Breath of the Wild.
By Aarav Borthakur
Concept
The Hyrule compendium is an encyclopedia of all in-game interactive items. With this brilliant API, you can access this data from code and embed it into your own application. See the compendium directory of this repository to see all entries in the compendium. 385 entries and 5 categories of entries are in the compendium.
You can see a specific item, all items in a category, or all data in our database. Here is an example request and response, retrieving data on the silver lynel:
$ curl http://botw-compendium.herokuapp.com/api/v1/entry/silver_lynel
{
"data": {
"category": "monsters",
"description": "Silver Lynels are not to be trifled with. They have been influenced by Ganon's fiendish magic, so they are the strongest among the Lynel species, surpassing even the strength of those with white manes. The term \"silver\" denotes not only their color but also their rarity. The purple stripes help them to stand out even more.",
"drops": [
"lynel horn",
"lynel hoof",
"lynel guts",
"topaz",
"ruby",
"sapphire",
"diamond",
"star fragment"
],
"id": 124,
"name": "silver lynel"
}
}
Let's get started!
API Refrence
The base URL is https://botw-compendium.herokuapp.com/api/v1.
/category
This endpoint is used for retrieving all entries in a category. The categories are:
- Creatures
- Equipment
- Materials
- Monsters
- Treasure
HTTP Request
GET https://botw-compendium.herokuapp.com/api/v1/category/<category>
Example Request
$ curl https://botw-compendium.herokuapp.com/api/v1/category/monsters
/entry
This endpoint is used for retrieving a specific entry, using it's name or ID. If you are using a name to search for an item, spaces are to be replaced with an underscore or "%20".
HTTP Request
GET https://botw-compendium.herokuapp.com/api/v1/entry/<entry>
Example Request
With name:
$ curl https://botw-compendium.herokuapp.com/api/v1/entry/moblin
With name with spaces:
$ curl https://botw-compendium.herokuapp.com/api/v1/entry/silver%20moblin
With ID:
$ curl https://botw-compendium.herokuapp.com/api/v1/entry/70
/
This endpoint is for retrieving all data.
HTTP Request
GET https://botw-compendium.herokuapp.com/api/v1
Example Request
$ curl https://botw-compendium.herokuapp.com/api/v1
Support and Suggestions
If you come across a malfunction or have any suggestions open an issue or a pull request.
Notes
If a key's value is null
, that means it's marked as "unknown" in the Hyrule Compendium.
The response schema of the "creatures" category is much different from the others, because it has two sub-categories ("food" and "non-food").
Client Libraries
Running locally
Instructions for running locally can be found here.
Status
Check the latest "test endpoints" workflow run to see if the server status.
Author
Made with awesomeness by @gadhagod.