---
title: "Browse Metacritic titles"
method: GET
path: "/metacritic/browse"
tags: ["Metacritic"]
---

# Browse Metacritic titles

`GET /metacritic/browse`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/metacritic/browse`
- Auth: API key in header `x-api-key`

Browse Metacritic titles by content type, optionally filtered by genre and ordered by Metascore, popularity, or release date. Returns paginated title cards with Metascore and user score.

## Query parameters

- `type` 'game' | 'movie' | 'tv', required
- `genre` string
- `sort` 'score' | 'popularity' | 'release_date' | 'oldest'
- `page` integer
- `per_page` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- MetacriticBrowseResponseDoc
  - `code` integer
  - `data` MetacriticBrowseResponse
    - `genre` string
    - `items` MetacriticBrowseItem[]
      - `description` string
      - `genres` MetacriticGenre[]
        - `id` integer: Metacritic genre id.
        - `name` string: Genre name, for example `Action RPG`.
      - `id` integer
      - `image` string
      - `metascore` MetacriticScoreSummary
        - `max` integer: Highest possible value of `score`, for example `100`.
        - `negative_count` integer: Number of negative reviews counted in the score.
        - `neutral_count` integer: Number of neutral (mixed) reviews counted in the score.
        - `positive_count` integer: Number of positive reviews counted in the score.
        - `review_count` integer: Number of reviews the score is based on.
        - `score` number: Score value on the scale given by `max`. Metascores are out of 100 and user scores out of 10.
        - `sentiment` string: Metacritic's verdict for the score, for example `Universal acclaim`.
        - `url` string: Metacritic page listing the reviews behind the score.
      - `premiere_year` integer
      - `rating` string
      - `release_date` string
      - `season_count` integer
      - `slug` string
      - `title` string
      - `type` string
      - `url` string
      - `user_score` number
    - `page` integer
    - `per_page` integer
    - `sort` string
    - `total` integer
    - `type` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)