smashbros APIsmashbros.com ↗
Access fighters, stages, items, Pokémon, assist trophies, and Smash Blog articles from smashbros.com via a structured JSON API with 9 endpoints.
What is the smashbros API?
This API exposes 9 endpoints covering the full Super Smash Bros. Ultimate roster, stages, items, Pokémon, assist trophies, and official blog content from smashbros.com. Use get_fighter_by_id to retrieve a specific fighter by number — padded or unpadded — getting back fields like is_dlc, series, youtube_url, and fighter_number. All base-game and DLC content is available, including a dedicated get_dlc_info endpoint that returns both DLC fighters and DLC stages in a single call.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/30adbd0c-a8fb-4921-abac-043dc79ef84d/get_all_fighters' \ -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 smashbros-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: Super Smash Bros. Ultimate SDK — browse fighters, stages, and DLC content."""
from parse_apis.super_smash_bros._ultimate_api import SmashBros, FighterNotFound
client = SmashBros()
# List the first few fighters from the full roster
for fighter in client.fightersummaries.list(limit=5):
print(fighter.name, fighter.series, fighter.is_dlc)
# Drill into one fighter's full details via the summary → detail navigation
first = client.fightersummaries.list(limit=1).first()
if first:
detail = first.details()
print(detail.name, detail.page_url, detail.youtube_url)
# Browse fighters grouped by series
for group in client.seriesgroups.list(limit=3):
print(group.series_name, [f.name for f in group.fighters])
# List DLC stages
for stage in client.stages.list(limit=3):
print(stage.name, stage.is_dlc)
# Get the combined DLC content overview
dlc = client.dlccontents.get()
for dlc_fighter in dlc.dlc_fighters[:3]:
print(dlc_fighter.name, dlc_fighter.series)
# Typed error handling for an invalid fighter lookup
try:
bad = client.fightersummaries.list(limit=1).first()
if bad:
bad.details()
except FighterNotFound as exc:
print(f"Fighter not found: {exc.fighter_id}")
print("exercised: fightersummaries.list / details / seriesgroups.list / stages.list / dlccontents.get")
Get the complete roster of fighters in Super Smash Bros. Ultimate, including base game and DLC characters. Each fighter entry includes number, name, series, DLC status, and image URLs.
No input parameters required.
{
"type": "object",
"fields": {
"fighters": "array of fighter objects with id, fighter_number, name, is_dlc, series, url, image_url, icon_url, and is_dash"
},
"sample": {
"data": {
"fighters": [
{
"id": "f001",
"url": "https://www.smashbros.com/en_US/fighter/01.html",
"name": "MARIO",
"is_dlc": false,
"series": "mario",
"is_dash": false,
"icon_url": "https://www.smashbros.com/assets_v2/img/fighter/mario/mark.png",
"image_url": "https://www.smashbros.com/assets_v2/img/fighter/mario/main.png",
"fighter_number": "01"
}
]
},
"status": "success"
}
}About the smashbros API
Fighter Data
get_all_fighters returns an array of every fighter with fields including id, fighter_number, name, is_dlc, series, image_url, icon_url, and is_dash. For deeper detail on a single character, get_fighter_by_id accepts a fighter number in either padded ('01') or unpadded ('1') format and adds youtube_url (or null if no reveal video is recorded) and series_icon_url. get_fighters_by_series groups the full roster by series, with each entry exposing series_name and a nested fighters array — useful for filtering characters from a specific franchise.
Stages, Items, and Battle Objects
get_all_stages returns every stage with name, image_url, and is_dlc — the is_dlc flag lets you separate base-game stages from paid content. get_all_items returns items with name, image_url, and a description field that is populated for featured items and null for others. get_all_pokemon and get_all_assist_trophies each return flat arrays with name and image_url; note that image_url may be null for some assist trophy entries.
DLC and Blog Content
get_dlc_info is a convenience endpoint that returns dlc_fighters (with fighter_number, name, and series) and dlc_stages (with name, image_url, and is_dlc) together, so you do not need to filter the full rosters yourself. get_smash_blog_articles returns official Super Smash Blog posts with id, date, title, description (an HTML string), and url — suitable for syndicating patch notes, character announcements, and update history.
The smashbros API is a managed, monitored endpoint for smashbros.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when smashbros.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 smashbros.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 fighter encyclopedia app displaying roster images, series origins, and DLC status using
get_all_fightersresponse fields. - Track the full DLC history of Super Smash Bros. Ultimate by querying
get_dlc_infofor both fighters and stages in one call. - Populate a series-filter UI by grouping characters from
get_fighters_by_seriesbyseries_name. - Embed fighter reveal videos in a media gallery using the
youtube_urlfield fromget_fighter_by_id. - Display a complete stage select screen with DLC labels using
name,image_url, andis_dlcfromget_all_stages. - Syndicate official patch and character announcement news using
get_smash_blog_articlesarticle titles, dates, and HTML descriptions. - Build a reference tool for in-game items and summonable characters using
get_all_items,get_all_pokemon, andget_all_assist_trophies.
| 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 smashbros.com have an official developer API?+
What does `get_fighter_by_id` return that `get_all_fighters` does not?+
get_fighter_by_id includes two additional fields not present in the list endpoint: youtube_url, which links to the fighter's official reveal video on YouTube (or null if unavailable), and series_icon_url, which points to the SVG sprite for the fighter's series. It also returns page_url, the direct URL to the fighter's page on smashbros.com.Are fighter move sets, frame data, or competitive statistics available?+
Is there a way to retrieve blog articles for a specific character or filter by date?+
get_smash_blog_articles returns all available articles as a flat array with id, date, title, description, and url. The endpoint does not accept filter parameters. Date or character filtering would need to be applied client-side. You can fork the API on Parse and revise it to add server-side filtering if needed.Why might `image_url` be null for some assist trophies?+
image_url field for assist trophy entries reflects what is present on the smashbros.com source page. For some assist trophies the source page does not include an image, so the field is returned as null rather than omitted. Check for null before rendering images in your application.