ROWorldDB APIroworlddb.com ↗
Access ROWorldDB SEA server data: equipment, cards, monsters, shop items, pets, and maps with stats, drop tables, and image URLs via 6 structured endpoints.
What is the ROWorldDB API?
The ROWorldDB SEA API exposes 6 endpoints covering the full Ragnarok Online World: Journey SEA server database — equipment, cards, monsters, shop items, pets, and world maps. The list_monsters endpoint alone returns per-monster stats, drop tables with item details, element, race, and body size, while list_equipment resolves stat names, job limits, set bonuses, and quality tiers into structured fields ready for direct use.
curl -X GET 'https://api.parse.bot/scraper/bb0b8f83-f9a5-4d9a-9d81-a64de4e3295e/list_equipment?search=tiara' \ -H 'X-API-Key: $PARSE_API_KEY'
List and search equipment items from the SEA server database. Returns enriched equipment data including resolved stat names, job limits, set bonuses, and image URLs. Supports filtering by name, equipment type, and quality tier. Results are paginated; each page fetches the full upstream dataset and slices locally, so page 1 is a full round trip. The dataset contains ~3200 items total.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number, starting from 1. |
| type | string | Filter by equipment type name (e.g. 'Weapon', 'Armor', 'Headwear', 'Shoes', 'Cape', 'Accessory', 'Off-Hand', 'Facewear', 'Mouthwear', 'Backwear', 'Costume', 'Exclusive') or numeric type ID. Case-insensitive. |
| limit | integer | Items per page. Clamped to 1-200. |
| search | string | Case-insensitive substring filter on equipment name. |
| quality | string | Filter by quality tier (numeric, e.g. '5' for gold, '6' for red). |
{
"type": "object",
"fields": {
"page": "current page number",
"items": "array of equipment objects with id, name, description, icon_url, quality, type, stats, conditions, suits, job_limits, and more",
"limit": "items per page",
"total": "total number of matching items across all pages",
"has_more": "whether more pages exist"
},
"sample": {
"data": {
"page": 1,
"items": [
{
"id": 10433019,
"icon": "icon_item_accessory_dingshetoushinan",
"name": "Headwear: Tiara of Fading Stars",
"type": "Headwear",
"buffs": [],
"stats": [
{
"name": "ATK%",
"value": 500,
"attribute_id": "201"
}
],
"suits": [],
"stunts": [],
"job_all": true,
"quality": 6,
"subtype": "Combat",
"type_id": 51,
"icon_url": "https://roworlddb.com/media/images/item/icon_item_accessory_dingshetoushinan.webp",
"conditions": [],
"job_limits": [],
"open_level": 1,
"subtype_id": 5101,
"description": "",
"is_handbook": true,
"fixed_affixes": [],
"refine_per_level": [
[
29,
4
]
]
}
],
"limit": 50,
"total": 4,
"has_more": false
},
"status": "success"
}
}About the ROWorldDB API
Equipment and Cards
The list_equipment endpoint returns paginated equipment records with fields including stats, conditions, suits, job_limits, and icon_url. You can filter by type (e.g. Weapon, Headwear, Accessory), quality tier (numeric strings like 5 for gold or 6 for red), and a case-insensitive search on item name. The limit parameter accepts 1–200 items per page, and has_more signals whether additional pages exist. The list_cards endpoint covers 195 cards with fields for effect, effect_lines, slot, obtain_sources, and icon_url. Cards can be filtered by slot, quality, and monster_type values such as mvp, mini, or elite.
Monsters and Shop Items
list_monsters returns monster records with level, type, race, element, body, stats, and a drops array that includes item details. The search parameter matches against both monster names and drop item names, making it useful for finding which monsters drop a specific item. Filters for element, race, body size, and type (e.g. MVP, Elite) are all supported. The response also includes an activities array listing in-game activity names and IDs. list_shop_items returns store inventory with store_name, tab_name, price, daily_limit, and icon_url, plus a full currencies and currency_groups array in every response — useful for building currency conversion or shop lookup tools.
Pets and Maps
list_pets returns approximately 31 pets with a levels array per pet that details skill progression and stat attributes at each tier, alongside quality and icon_url. The dataset is small enough to return in a single response; quality values range from 3 (Common/N) to 6 (Legendary/SSR). list_maps returns 13 world map regions via world_maps (with pic_url and center_scene_id) and approximately 380 map zone configurations via map_configs, each containing scene_id, name, pic_res, and scene coordinates. Both collections support a search filter on map name.
The ROWorldDB API is a managed, monitored endpoint for roworlddb.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when roworlddb.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 roworlddb.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 character equipment planner filtered by job class using
job_limitsandstatsfromlist_equipment - Generate a card recommendation tool by querying
list_cardswithslotandmonster_typefilters - Create a monster drop index by searching
list_monsterswith an item name in thesearchparameter - Display in-game shop inventory with pricing and daily limits sourced from
list_shop_items - Build a pet tier list or leveling guide using the
levelsprogression array fromlist_pets - Render an interactive world map viewer using
world_mapsregion data andmap_configsscene coordinates - Identify set bonus combinations by extracting the
suitsfield fromlist_equipmentresponses
| 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 ROWorldDB have an official developer API?+
How do I find which monsters drop a specific item?+
search parameter to list_monsters. The search matches against both monster names and drop item names within each monster's drops array, so you get back every monster that lists that item as a drop.What does the `list_shop_items` response include beyond item listings?+
list_shop_items response includes the full currencies array (with id, name, and iconPath per currency) and a currency_groups array, regardless of pagination or filters applied. This means you can bootstrap currency metadata from any shop query without a separate call.