Fandom APIblox-fruits.fandom.com ↗
Access Blox Fruits wiki data via API: all fruits with rarity, type, prices, move details, and live dealer stock with rotation timers.
What is the Fandom API?
This API exposes 3 endpoints covering every Blox Fruit listed on the Blox Fruits Fandom wiki, returning fields like rarity, type, money and Robux prices, image URLs, and full movesets. The get_fruits endpoint retrieves the complete fruit catalog with optional rarity filtering, while get_stock delivers live dealer inventory for both the normal Blox Fruit Dealer and the Mirage Island dealer, including countdown timestamps for the next rotation.
curl -X GET 'https://api.parse.bot/scraper/78cf8155-3819-45d0-b799-92f840a94827/get_fruits?rarity=Common' \ -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 blox-fruits-fandom-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.
"""Walkthrough: Blox Fruits Wiki SDK — list fruits, check stock, get details."""
from parse_apis.blox_fruits_fandom_com_api import BloxFruits, Rarity, FruitNotFound
client = BloxFruits()
# List all Mythical fruits — limit caps total items fetched
for fruit in client.fruit_summaries.list(rarity=Rarity.MYTHICAL, limit=5):
print(fruit.name, fruit.rarity, fruit.type, fruit.money_price)
# Drill into one fruit's full details (moves, m1 info)
summary = client.fruit_summaries.list(rarity=Rarity.LEGENDARY, limit=1).first()
if summary:
detail = summary.details()
print(detail.name, detail.type, detail.m1_enabled)
for move in detail.moves[:3]:
print(f" [{move.key}] {move.name}: {move.description[:60]}")
# Check the current in-game dealer stock
stock = client.stocks.get()
print(f"Normal dealer resets at: {stock.normal_resets_at}")
for item in stock.normal:
print(f" {item.name} ({item.type}) — ${item.money_price}")
print(f"Mirage dealer resets at: {stock.mirage_resets_at}")
for item in stock.mirage:
print(f" {item.name} ({item.type}) — ${item.money_price}")
# Typed error handling on a detail lookup
try:
first_fruit = client.fruit_summaries.list(limit=1).first()
if first_fruit:
full = first_fruit.details()
print(full.name, full.image_url)
except FruitNotFound as exc:
print(f"Fruit not found: {exc.fruit_name}")
print("exercised: fruit_summaries.list / details / stocks.get / FruitNotFound")
Retrieves all available Blox Fruits with their name, rarity, type, in-game prices, and image URL. Results can be filtered by rarity. Returns fruits in their natural game ordering.
| Param | Type | Description |
|---|---|---|
| rarity | string | Filter fruits by rarity tier. Case-insensitive. When omitted, all fruits are returned. |
{
"type": "object",
"fields": {
"total": "integer",
"fruits": "array of fruit summary objects with name, rarity, type, money_price, robux_price, image_url, wiki_url"
},
"sample": {
"data": {
"total": 41,
"fruits": [
{
"name": "Rocket",
"type": "Natural",
"rarity": "Common",
"wiki_url": "https://blox-fruits.fandom.com/wiki/Rocket",
"image_url": "https://static.wikia.nocookie.net/roblox-blox-piece/images/c/cb/Rocket_Fruit.png/revision/latest?cb=20231027120039",
"money_price": 5000,
"robux_price": 50
}
]
},
"status": "success"
}
}About the Fandom API
Fruit Catalog
The get_fruits endpoint returns every fruit in the game as a summary array. Each object includes name, rarity, type, money_price, robux_price, image_url, and wiki_url. The optional rarity parameter filters the result set by tier (e.g. Legendary, Mythical, Common) and is case-insensitive. The total field in the response reflects the filtered count. Fruits are returned in their natural in-game ordering.
Fruit Details and Movesets
The get_fruit_details endpoint accepts a single required parameter, fruit_name, which must exactly match the wiki page title (e.g. Dragon, T-Rex, Kitsune). The response includes the complete moveset as an array of move objects, each with key (hotkey), name, and description. Additional fields include type, rarity, money_price, robux_price, image_url, wiki_url, and m1_enabled, which indicates whether the fruit's basic attack is available.
Live Dealer Stock
The get_stock endpoint requires no parameters and returns the current and immediately previous stock for two in-game dealers. The normal array reflects the standard Blox Fruit Dealer rotation (every 4 hours), and the mirage array reflects the Mirage Island dealer (every 2 hours). Each stock entry includes name, type, money_price, and robux_price. The response also provides normal_resets_at, mirage_resets_at, normal_resets_at_epoch, and mirage_resets_at_epoch so you can build countdown timers or schedule refreshes without polling continuously.
The Fandom API is a managed, monitored endpoint for blox-fruits.fandom.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when blox-fruits.fandom.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 blox-fruits.fandom.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 fruit tracker dashboard showing current dealer stock and time until the next rotation using
normal_resets_atandmirage_resets_at. - Filter all
MythicalorLegendaryfruits via therarityparameter to display tier-specific pricing guides. - Compare
money_priceandrobux_priceacross fruits to help players decide which fruit to save for. - Render a fruit detail page with full moveset descriptions using the
movesarray fromget_fruit_details. - Notify users when a specific fruit appears in dealer stock by polling
get_stockand checking thenamefields. - Display fruit images and wiki links using
image_urlandwiki_urlin a game companion app or Discord bot. - Track historical stock patterns by logging
previous_normalandprevious_miragearrays over time.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does the Blox Fruits Fandom wiki have an official developer API?+
What does `get_stock` return, and how current is it?+
name, type, money_price, and robux_price. The normal_resets_at and mirage_resets_at fields (ISO-8601 UTC) and their epoch equivalents indicate when each stock next changes, reflecting the wiki's published stock page.Does `get_fruit_details` accept partial or fuzzy fruit names?+
fruit_name parameter must exactly match the wiki page title, including correct capitalization and punctuation (e.g. T-Rex not t rex, Kitsune not kitsune). The endpoint fetches details for one fruit per call, so batch lookups require one request per fruit.