Skip to main content
GET
/
ratings
/
systems
SDK (@phosra/sdk)
import { PhosraClient } from "@phosra/sdk";

const phosra = new PhosraClient({
  baseUrl: "https://phosra-api-sandbox-production.up.railway.app/api/v1",
  accessToken: process.env.PHOSRA_API_KEY,
});

const result = await phosra.ratings.systems();
console.log(result);
[
  {
    "id": "csm",
    "name": "Common Sense Media",
    "country": "US",
    "media_type": "general",
    "description": "Common Sense Media age-based ratings"
  },
  {
    "id": "esrb",
    "name": "ESRB",
    "country": "US",
    "media_type": "game",
    "description": "Entertainment Software Rating Board"
  }
]
Rating systems are the content-classification vocabularies Phosra maps against — MPAA, ESRB, PEGI, Common Sense Media, and the US TV Parental Guidelines. This endpoint is public; use it to discover the id you pass to the other ratings endpoints. 
curl https://phosra-api-sandbox-production.up.railway.app/api/v1/ratings/systems
Example response (live sandbox)
[
  { "id": "csm",  "name": "Common Sense Media", "country": "US", "media_type": "general", "description": "Common Sense Media age-based ratings" },
  { "id": "esrb", "name": "ESRB",  "country": "US", "media_type": "game",  "description": "Entertainment Software Rating Board" },
  { "id": "mpaa", "name": "MPAA",  "country": "US", "media_type": "movie", "description": "Motion Picture Association of America film rating system" },
  { "id": "pegi", "name": "PEGI",  "country": "EU", "media_type": "game",  "description": "Pan European Game Information" },
  { "id": "tvpg", "name": "TV Parental Guidelines", "country": "US", "media_type": "tv", "description": "US television content rating system" }
]

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

Rating systems

​
id
string

Unique identifier for this resource.

​
name
string

Human-readable display name.

​
country
string

ISO country associated with this resource.

​
media_type
string

Type of media the rating system applies to (e.g. game, film, general).

​
description
string

Human-readable description.