Find Player

GET https://marvelrivalsapi.com/api/v1/find-player/:username

This endpoint retrieves player uid for a specific player identified by their username. It returns basic player information such as name, unique identifier (UID), and tracks API usage.

Headers

Name	Value
Content-Type	application/json
x-api-key*	YOUR API KEY

Query Parameters

Name	Type	Required	Description
username*	string	✔️	The username of the player

Example Requests

cURL

curl -X GET "https://marvelrivalsapi.com/api/v1/find-player/Sypeh"
     -H "x-api-key: YOUR_API_KEY"

Node.js

const axios = require("axios");

try {
    const response = await axios.get("https://marvelrivalsapi.com/api/v1/find-player/Sypeh", {
        headers: {
            "x-api-key": "YOUR_API_KEY"
        }
    });
    console.log(response.data);
} catch (error) {
    console.error("Error fetching balances:", error.response ? error.response.data : error.message);
}

Python

import requests

url = "https://marvelrivalsapi.com/api/v1/find-player/Sypeh"
headers = {
    "x-api-key": "YOUR_API_KEY"
}

response = requests.get(url, headers=headers)

if response.status_code == 200:
    print(response.json())
else:
    print(f"Error {response.status_code}: {response.text}")

Java

import java.net.http.*;
import java.net.URI;
import java.io.IOException;

public class ApiClient {
    public static void main(String[] args) {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://marvelrivalsapi.com/api/v1/find-player/Sypeh"))
            .header("x-api-key", "YOUR_API_KEY")
            .GET()
            .build();

        try {
            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
            System.out.println(response.body());
        } catch (IOException | InterruptedException e) {
            e.printStackTrace();
        }
    }
}

Response

200

{
  "name": "Player One",
  "uid": "123456"
}

400

{
  "error": true,
  "message": "Player Username is required",
  "status": 400
}

401

{
  "error": true,
  "message": "Invalid or missing API key.",
  "status": 401
}

500

{
  "error": true,
  "message": "An error occurred while fetching player data.",
  "status": 500
}

Response Field Descriptions

Field	Type	Description
name	String	The name of the player (e.g., "Player One").
uid	String	Unique identifier for the player (e.g., "123456").