Fortnite Power Rankings API: The Complete Guide

What Are Power Rankings?

Power Rankings (PR) are Epic Games' official competitive skill rating for Fortnite. Players earn PR points by placing in tournaments — cash cups, FNCS, console cups — and the rating ranks the top 10,000 competitive players. If you're building anything around the Fortnite competitive scene — a leaderboard site, an esports coverage tool, a Discord bot for a competitive server — PR is the number everyone wants to see.

Very few APIs expose this data. Ours does, behind one API key. This guide walks through every Power Rankings endpoint with examples you can paste into a terminal.

All Power Rankings endpoints are available on the Pro plan. You can create a free account first to explore the rest of the API.

The Leaderboard

The main endpoint returns the Power Rankings leaderboard, paginated:

curl -H "x-api-key: YOUR_API_KEY" \
  "https://prod.api-fortnite.com/api/v1/events/powerrankings?page=0"

Increase page to walk down the rankings. Each entry carries the player's rank and PR points, so rendering a leaderboard table is a straight map over the response.

There is also an accountId query parameter on the same endpoint if you want the leaderboard positioned around a specific player.

Searching Players by Name

You usually don't have an Epic account ID — you have a name someone typed into a search box. The search endpoint takes a partial, case-insensitive display name:

curl -H "x-api-key: YOUR_API_KEY" \
  "https://prod.api-fortnite.com/api/v1/events/powerrankings/search?q=peterbot"

Add limit to cap the number of results. This is the endpoint to wire directly to an autocomplete input.

Looking Up a Single Player

Search results already carry everything you need for a profile card — rank, score (PR points), peakPr, deltaPr and countingEvents — so for most lookups, search is the lookup:

curl -H "x-api-key: YOUR_API_KEY" \
  "https://prod.api-fortnite.com/api/v1/events/powerrankings/search?q=peterbot&limit=1"

When you already have an account ID, the archive endpoint returns that player's most recent PR entry (rank, score, best rank, peak PR, season label):

curl -H "x-api-key: YOUR_API_KEY" \
  "https://prod.api-fortnite.com/api/v1/events/powerrankings/archive/{accountId}"

There is also /api/v1/events/powerrankings/player/{identifier} with fuller tracked stats, but Epic only serves it with the looked-up player's own OAuth token — pass it as x-fortnite-token alongside your API key. Without that token it returns 400 for every account, so for public tools, stick to search + archive.

A Minimal JavaScript Client

const BASE = "https://prod.api-fortnite.com";
const headers = { "x-api-key": process.env.FORTNITE_API_KEY };

async function prSearch(name) {
  const res = await fetch(
    `${BASE}/api/v1/events/powerrankings/search?q=${encodeURIComponent(name)}&limit=5`,
    { headers },
  );
  if (!res.ok) throw new Error(`PR search failed: ${res.status}`);
  return res.json();
}

async function prLeaderboard(page = 0) {
  const res = await fetch(
    `${BASE}/api/v1/events/powerrankings?page=${page}`,
    { headers },
  );
  if (!res.ok) throw new Error(`PR leaderboard failed: ${res.status}`);
  return res.json();
}

In a Discord bot, prSearch maps naturally onto a /pr <name> slash command: search, take the top hit, reply with rank and points.

Caching Advice

Power Rankings move when Epic publishes new standings after tournament sessions — not minute to minute. Cache leaderboard pages for 15–30 minutes and you'll stay fresh while making a fraction of the requests:

// Next.js
const res = await fetch(url, {
  headers: { "x-api-key": process.env.FORTNITE_API_KEY! },
  next: { revalidate: 1800 },
});

Pair It With Tournament Data

PR points come from tournament results, and the same API serves those too: active and upcoming events (/api/v1/events/global), eligibility checks, event-window leaderboards and raw tournament replay downloads. See the Fortnite Tournaments API page for the full competitive surface, or the Power Rankings API overview for a summary of everything covered here.

Related Guides