All Recent Game Awards

A call to this endpoint will retrieve all recently granted game awards across the site's userbase.

• On-site Representation
• HTTP Request
  • Query Parameters
• Client Library
• Response
• Source

On-site Representation

This data can be found on the Recent Game Awards page, for example:

HTTP Request

GET

https://retroachievements.org/API/API_GetRecentGameAwards.php

Query Parameters

Name	Required?	Description
y	Yes	Your web API key.
d		Starting date (YYYY-MM-DD) (default: now).
o		Offset, number of entries to skip (default: 0).
c		Count, number of entries to return (default: 25, maximum: 100).
k		A comma-separated list of desired game award kinds. Possible values are "beaten-softcore", "beaten-hardcore", "completed", and "mastered" (default: all game award kinds).

Client Library

NodeJS

import {
  buildAuthorization,
  getRecentGameAwards,
} from "@retroachievements/api";

// First, build your authorization object.
const username = "<your username on RA>";
const webApiKey = "<your web API key>";

const authorization = buildAuthorization({ username, webApiKey });

// Then, make the API call.
const game = await getRecentGameAwards(authorization);

Response

HTTP Response

{
  "Count": 25,
  "Total": 172318,
  "Results": [
    {
      "User": "renanbrj",
      "AwardKind": "mastered",
      "AwardDate": "2022-01-01T23:48:04+00:00",
      "GameID": 14284,
      "GameTitle": "Batman Returns",
      "ConsoleID": 15,
      "ConsoleName": "Game Gear"
    }
    // ...
  ]
}

NodeJS

{
  "count": 25,
  "total": 452857,
  "results": [
    {
      "user": "renanbrj",
      "awardKind": "mastered",
      "awardDate": "2022-01-01T23:48:04+00:00",
      "gameId": 14_284,
      "gameTitle": "Batman Returns",
      "consoleId": 15,
      "consoleName": "Game Gear"
    }
    // ...
  ]
}

Source

Repo	URL
RAWeb	https://github.com/RetroAchievements/RAWeb/blob/master/public/API/API_GetRecentGameAwards.php
api-js	https://github.com/RetroAchievements/api-js/blob/main/src/feed/getRecentGameAwards.ts