Prydwen APIprydwen.gg ↗
Access Wuthering Waves character build data from Prydwen.gg: tier ratings, skills with multiplier tables, weapons, echoes, team comps, and rotation guides.
What is the Prydwen API?
This API exposes Wuthering Waves character build data from Prydwen.gg across 2 endpoints, returning over 10 structured response fields per character — including skill multiplier matrices, weapon rankings with performance percentages, tier ratings, and rotation steps. The get_character_build endpoint delivers a full build guide for any character by slug, while list_characters returns the complete roster with element and rarity data.
curl -X GET 'https://api.parse.bot/scraper/d96bfcfc-3bf2-46e4-a231-21367a6eb8c4/get_character_build?slug=camellya' \ -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 prydwen-gg-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: PrydwenWuWa SDK — bounded, re-runnable; every call capped."""
from parse_apis.Prydwen_Wuthering_Waves_API import PrydwenWuWa, CharacterNotFound
client = PrydwenWuWa()
# List all characters — single-page roster
for char in client.character_summaries.list(limit=3):
print(char.name, char.slug, char.rarity_stars, char.element)
# Drill down from a summary to its full build guide
summary = client.character_summaries.list(limit=1).first()
build = summary.details()
print(build.character_metadata.name, build.character_metadata.element)
print(build.ratings.dps_ratings.tower_of_adversity.tier)
# Direct fetch by slug
try:
full = client.character_builds.get(slug="camellya")
print(full.character_metadata.name, full.best_weapons[0].weapon_name)
except CharacterNotFound as e:
print(f"not found: {e.slug}")
print("exercised: character_summaries.list, CharacterSummary.details, character_builds.get")
Retrieve a comprehensive character build guide including metadata, tier ratings, skills with full multiplier tables, best weapons and echoes, team compositions, rotation guides, and synergies. Each character page is a single fetch containing all build-relevant data.
| Param | Type | Description |
|---|---|---|
| slugrequired | string | URL slug of the character (e.g. 'camellya', 'carlotta', 'the-shorekeeper'). Lowercase with hyphens for multi-word names. |
{
"type": "object",
"fields": {
"media": "object with youtube_guide_embed_url, youtube_guide_full_url, full_image_gallery_url",
"review": "object with summary string and sections array (heading + paragraphs)",
"skills": "array of skill objects with name, category, skill_type, description, and multipliers level matrix",
"ratings": "object with dps_ratings (tower_of_adversity, whimpering_wastes tiers/tags) and value_tier_ratings",
"rotations": "array of rotation guides with rotation_name and steps",
"synergies": "array of synergy entries with characters and commentary",
"best_weapons": "array of recommended weapons with performance percentages and details",
"minor_fortes": "array of stat bonuses with stat_name and bonus_value",
"voice_actors": "object with eng, jpn, cn, kr voice actor names",
"example_teams": "array of team compositions with slots and alternatives",
"pros_and_cons": "object with pros and cons arrays of strings",
"best_echo_sets": "array of echo/sonata set recommendations",
"best_echo_stats": "object with main_stats (cost_4, cost_3, cost_1) and substats_priority",
"base_stats_lvl_90": "object with hp, atk, def, max_energy, crit_rate, crit_dmg, healing_bonus, elemental_dmg_bonus",
"upgrade_materials": "object with character_ascension and skill_upgrades arrays",
"character_metadata": "object containing name, slug, rarity_stars, element, weapon_type, breadcrumb, and updates",
"resonance_chain_dupes": "array of S1-S6 sequence nodes with node, name, and description",
"skill_upgrade_priority": "object with order array and commentary",
"recommended_endgame_stats_target": "array of target stat strings"
},
"sample": {
"data": {
"media": {
"full_image_gallery_url": "https://cdn.prydwen.gg/images/wuthering-waves/characters/camellya_full.webp",
"youtube_guide_full_url": "https://www.youtube.com/watch?v=__6ChxZLgdU",
"youtube_guide_embed_url": "https://www.youtube.com/embed/__6ChxZLgdU"
},
"review": {
"summary": "Camellya is a 5-star Havoc Sword main damage dealer known for having one of, if not the longest, rotation times of any Main DPS character in the game.",
"sections": [
{
"heading": "Summary",
"paragraphs": [
"Camellya is a 5-star Havoc Sword main damage dealer..."
]
},
{
"heading": "Key Mechanics",
"paragraphs": [
"Camellya's main rotation goals..."
]
}
]
},
"skills": [
{
"name": "Burgeoning",
"category": "Active",
"skill_type": "Basic Attack",
"description": "<p><b>Basic Attack</b></p>...",
"multipliers": [
{
"Lv1": "31.45%",
"Lv2": "34.03%",
"Lv3": "36.61%",
"Lv4": "40.22%",
"Lv5": "42.80%",
"Lv6": "45.77%",
"Lv7": "49.89%",
"Lv8": "54.02%",
"Lv9": "58.15%",
"Lv10": "62.53%",
"Name": "Basic Attack 1 DMG"
}
]
}
],
"ratings": {
"dps_ratings": {
"whimpering_wastes": {
"tags": [],
"tier": "T3"
},
"tower_of_adversity": {
"tags": [],
"tier": "T2"
}
},
"value_tier_ratings": {
"whimpering_wastes_value": {
"tier": "T2"
},
"tower_of_adversity_value": {
"tier": "T3"
}
}
},
"rotations": [
{
"steps": [
"Intro",
"Skill: Crimson Blossom",
"Echo"
],
"rotation_name": "Standard Rotation:"
}
],
"synergies": [
{
"characters": [
"roccia",
"lynae",
"sanhua"
],
"commentary": "The best Hybrid choices for Camellya..."
}
],
"best_weapons": [
{
"dupe_rank": "R1",
"weapon_name": "Red Spring",
"weapon_base_info": {
"rarity": 5,
"source": "Gacha",
"primary_stat_val": 0,
"effect_description": "Increase ATK by {0}...",
"secondary_stat_val": 0,
"secondary_stat_name": ""
},
"commentary_details": "Camellya's Signature is strong on a lot of Sword users...",
"percentage_performance": "100.00%"
}
],
"minor_fortes": [
{
"stat_name": "CRIT DMG",
"bonus_value": "+16%"
},
{
"stat_name": "ATK%",
"bonus_value": "+12%"
}
],
"voice_actors": {
"cn": "",
"kr": "",
"eng": "",
"jpn": ""
},
"example_teams": [
{
"slot_1": {
"alternatives": [],
"character_name": "camellya"
},
"slot_2": {
"alternatives": [
"roccia",
"sanhua"
],
"character_name": "lynae"
},
"slot_3": {
"alternatives": [
"the-shorekeeper",
"verina"
],
"character_name": "mornye"
},
"team_name": "Best Team",
"team_notes": "Mornye is only best with Lynae on the team."
}
],
"pros_and_cons": {
"cons": [
"Very old DPS, has not gotten a rerun in ages to take advantage of her sequence value;"
],
"pros": [
"Super F2P-friendly AoE DPS can use completely free teammates and weapons and yield great results;"
]
},
"best_echo_sets": [
{
"set_name": "Havoc Eclipse",
"commentary": "Offers a 10% unconditional Havoc DMG% boost...",
"main_echo_options": [
{
"echo_name": "Nightmare: Crownless",
"echo_commentary": "Offers an unconditional 12% Havoc DMG..."
}
],
"percentage_performance": "100.00%"
}
],
"best_echo_stats": {
"main_stats": {
"cost_1": [
"ATK%"
],
"cost_3": [
"Havoc DMG"
],
"cost_4": [
"CRIT Rate / CRIT DMG"
]
},
"substats_priority": [
"Energy Regen (Until Satisfied)",
"CRIT Rate = CRIT DMG",
"ATK%"
]
},
"base_stats_lvl_90": {
"hp": 826,
"atk": 36,
"def": 95,
"crit_dmg": "166%",
"crit_rate": "5%",
"max_energy": 125,
"healing_bonus": "0%",
"elemental_dmg_bonus": "0%"
},
"upgrade_materials": {
"skill_upgrades": [
{
"rarity": "weekly_boss",
"quantity": 26,
"material_name": "Dreamless Feather"
}
],
"character_ascension": [
{
"rarity": "boss",
"quantity": 60,
"material_name": "Nova"
}
]
},
"character_metadata": {
"name": "Camellya",
"slug": "camellya",
"element": "Havoc",
"updates": {
"last_updated": "10/July/2026",
"last_review_patch": "1.4",
"last_profile_update": "10/July/2026",
"last_major_build_patch": "2.2"
},
"breadcrumb": [
"Wuthering Waves",
"Characters",
"Camellya"
],
"weapon_type": "Sword",
"rarity_stars": 5
},
"resonance_chain_dupes": [
{
"name": "Sequence Node 1",
"node": "S1",
"description": "Casting Intro Skill Everblooming increases Camellya's Crit. DMG by 28% for 18s."
}
],
"skill_upgrade_priority": {
"order": [
"Res. Skill",
"Forte Circuit",
"Res. Liberation"
],
"commentary": "Basic can and should be levelled if using the White Hair rotation..."
},
"recommended_endgame_stats_target": [
"HP: 15000+",
"DEF: 1150+",
"ATK: 2000-2200+"
]
},
"status": "success"
}
}About the Prydwen API
Character Build Data
The get_character_build endpoint accepts a slug parameter (e.g. camellya, the-shorekeeper) and returns a single object containing everything Prydwen.gg publishes for that character. The skills array includes each skill's name, category, type, description, and a full level-by-level multiplier matrix. The best_weapons array lists recommended weapons with relative performance percentages, letting you compare options numerically rather than by vague tier label.
Ratings and Team Compositions
The ratings field breaks character performance into dps_ratings — with separate entries for Tower of Adversity and Whimpering Wastes, each tagged with tier and contextual tags — and value_tier_ratings. The example_teams array provides concrete slot-by-slot team compositions with named alternatives, and synergies pairs those teams with commentary explaining why specific characters work together.
Rotation and Supporting Metadata
The rotations array contains named rotation guides broken into discrete steps, giving a programmatic representation of skill sequencing. Supplementary fields include minor_fortes (stat bonuses with exact values), voice_actors (EN, JP, CN, KR), and media links including the YouTube guide embed URL and full image gallery URL. The review field carries a structured editorial object with summary text and headed sections.
Roster Enumeration
list_characters requires no parameters and returns the full playable roster as an array of objects, each with name, slug, rarity_stars, and element. The slug values map directly to the slug input of get_character_build, making it straightforward to iterate the roster and fetch detailed builds in sequence.
The Prydwen API is a managed, monitored endpoint for prydwen.gg — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when prydwen.gg 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 prydwen.gg 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 tier list sorted by Tower of Adversity and Whimpering Wastes ratings from the
dps_ratingsfield - Compare weapon options numerically using the performance percentages in
best_weaponsfor any character - Generate rotation cheat sheets from the
rotationssteps array for in-game reference tools - Populate a team builder UI with
example_teamsslot data and named alternatives - Display skill damage scaling by pulling the multiplier level matrix from the
skillsarray - Filter the full character roster by
elementorrarity_starsusinglist_charactersoutput - Sync voice actor credits to a character database using the
voice_actorsEN/JP/CN/KR fields
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Prydwen.gg provide an official developer API?+
What does `get_character_build` return beyond basic stats?+
Does `list_characters` return build details or just roster metadata?+
name, slug, rarity_stars, and element per character. Full build data — weapons, skills, rotations, ratings — is only available through get_character_build using the slug from this list.Is data available for Wuthering Waves content other than playable characters, such as enemies or story bosses?+
How current is the character data, and are unreleased or beta characters included?+
list_characters or resolve via get_character_build.