TL;DR
XIVAPI is the largest public API for Final Fantasy XIV game data, providing access to items, characters, free companies, market board prices, achievements, mounts, minions, recipes, and more. The API indexes data directly from the game's files across all expansions from A Realm Reborn through Dawntrail. Search by ID, name, or use the powerful search endpoint with filters. No API key required. Extremely fast response times thanks to Elasticsearch indexing.
Quick start: https://xivapi.com/item/1
No API key needed — free for FFXIV community projects!
How to Use This API
1. Get Item by ID
https://xivapi.com/item/1
Item #1 is a "Potion" — returns name, description, icon URL, item level, category, and stats.
2. Search Items by Name
https://xivapi.com/search?indexes=item&string=Glamour&filters=item_level>=300
3. Get Character Data
https://xivapi.com/character/123456
4. JavaScript — Item Search Tool
async function searchFFXIV(query) {
const r = await fetch(
`https://xivapi.com/search?indexes=item&string=${encodeURIComponent(query)}&limit=10`
);
const data = await r.json();
return data.Results;
}
searchFFXIV('The Emperor\'s New').then(items => {
items.forEach(i => {
console.log(i.Name, '—', i.ItemLevel, '—', i.Icon);
});
});
5. Python — Market Board Prices
import requests
# Get market data for item ID 5 (Hi-Potion)
item_id = 5
r = requests.get(f'https://xivapi.com/market/{item_id}')
if r.status_code == 200:
data = r.json()
print(f"Item: {data['item']['Name']}")
print(f"Min price: {data['minPrice']} gil")
print(f"Sale velocity: {data['saleVelocity']}/day")
https://xivapi.com/item/1
Frequently Asked Questions
- What game data is indexed?
- All items, characters, free companies, linkshells, achievements, mounts, minions, orchestrion rolls, recipes, fishing data, quests, and instances.
- Can I search by Japanese or French names?
- Yes — XIVAPI supports all three game languages (EN, JP, FR, DE). Use
language=en,language=jp,language=fr, orlanguage=de. - Does the API cover market board data?
- Yes — market board endpoints return current prices, sale velocity, and history for any item across all data center worlds.
- What is the rate limit?
- 10 requests per second for the public API. For higher limits, consider registering for a free API key.
- Does it include character gear and stats?
- Yes — the character endpoint returns full gear sets, attributes, job levels, minions, mounts, and achievements for public characters.
- How current is the game data?
- The database is updated with each game patch (typically every 3-4 months for major patches, plus hotfixes). Market board data is near real-time.
API Details
- API URL
https://xivapi.com/item/{id}- Documentation
- xivapi.com
- Category
- Games
- Authentication
- Not Required (free key available for higher limits)
- Geographic Coverage
- Global — FFXIV game data across all regions
What You Can Build
- Glamour outfit planner with item search and preview
- Market board price tracker for crafting profitability
- Character profile viewer for FC recruitment pages
- Crafting recipe calculator with material lists
- Treasure map and fishing data aggregator for FC events