MarvelRivalsAPI.com
    MarvelRivalsAPI.com
    • Introduction
    • Get Started
      • Authentication
      • Rate Limits
      • Errors
        • Status Codes
      • SDKs & Extentions
        • Community Libraries
    • Endpoints
      • Achievements
        • List achievements
        • Search achievement
      • Patch Notes
        • List balances
        • Search balance
        • List dev diaries
        • Search dev diary
        • List patch notes
        • Search patch note
        • List game versions
      • Battle Pass
        • Battlepass
      • Heroes
        • List Heroes
        • Search hero
        • Hero stats
        • Hero leaderboard
        • List costumes
        • Search hero costume
      • Items
        • List items
        • Search item
      • Maps
        • List maps
        • Search map
      • Player Match History
        • Search match
        • Player match history
        • Player match history v2
      • Player Stats
        • Search player
        • Player stats
        • Player stats v2
        • Update player
        • Player Leaderboard

    Introduction

    Learn how to use the Marvel Rivals API to access game data like player stats, achievements, maps, heroes, store items, and more. This documentation will walk you through authentication, key features, and available endpoints.
    This documentation is actively maintained.
    Please check back regularly for updates as the API and game evolve.

    Overview#

    The MarvelRivalsAPI.com is a RESTful interface that was designed to provide developers access to real-time data from the Marvel Rivals.
    Whether you're building:
    A fan site
    A Discord bot
    Analytics tool
    Or an internal tool
    ...this API gives you reliable, powerful access to the Marvel Rivals universe.

    Getting Started#

    Before you start exploring the Marvel Rivals API, first you need to obtain an API key from the dashboard.
    API Key Required
    All requests require a valid x-api-key header.
    Generate your key on MarvelRivalsAPI.com
    Once you have your key, include it in the x-api-key header of every request

    Base URL's#

    https://marvelrivalsapi.com/api/v1
    https://marvelrivalsapi.com/api/v2

    Base Image URL#

    The API returns only partial paths for images (e.g. /costumes/bruce-banner-1011001.png).
    To render the full image, prepend the following base URL:
    https://marvelrivalsapi.com/rivals

    Premium Images & Videos#

    Premium image endpoints are different. They return full signed paths like:
    /premium/heroes/badges/gold/head_badge_gold_1032.png?expires=1753281474&signature=08617864524e12c29016c0539505dd92e96abe463f2595c73b1dde461d8ee815
    To render the image, prepend:
    https://marvelrivalsapi.com
    These links are time-limited and return 403 if expired or tampered with.
    Only available to Premium and Partner users.

    Disclaimer#

    The unofficial game API was not explicitly made usable by their entities for third parties and thus may be subject to change at any time. This project will be updated to reflect any changes to the data source.
    Modified at 2025-07-25 17:28:32
    Next
    Authentication
    Built with