Final Fantasy XIV (XIVAPI)

Games API · FFXIV game data · Items, characters, market board

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")
Item #1 (Potion): 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, or language=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