smashbros.com 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.
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'
Get a list of all fighters in the game, including base roster and DLC characters. Returns fighter metadata such as name, series, number, 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.com 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.
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.
- 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 | 250 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.