RAWG games API

openapi: 3.2.0
info:
  title: RAWG Video Database creator-roles Games API
  description: '

    The largest open video games database.


    ### Why build on RAWG

    - More than 350,000 games for 50 platforms including mobiles.

    - Rich metadata: tags, genres, developers, publishers, individual creators, official websites, release dates,

    Metacritic ratings.

    - Where to buy: links to digital distribution services

    - Similar games based on visual similarity.

    - Player activity data: Steam average playtime and RAWG player counts and ratings.

    - Actively developing and constantly getting better by user contribution and our algorithms.


    ### Terms of Use

    - Free for personal use as long as you attribute RAWG as the source of the data and/or images and add an active

    hyperlink from every page where the data of RAWG is used.

    - Free for commercial use for startups and hobby projects with not more than 100,000 monthly active users or 500,000

    page views per month. If your project is larger than that, email us at [api@rawg.io](mailto:api@rawg.io) for

    commercial terms.

    - No cloning. It would not be cool if you used our API to launch a clone of RAWG. We know it is not always easy

    to say what is a duplicate and what isn''t. Drop us a line at [api@rawg.io](mailto:api@rawg.io) if you are in doubt,

    and we will talk it through.

    - You must include an API key with every request. The key can be obtained at https://rawg.io/apidocs.

    If you don’t provide it, we may ban your requests.


    __[Read more](https://rawg.io/apidocs)__.

    '
  version: v1.0
servers:
- url: https://api.rawg.io/api
tags:
- name: games
paths:
  /games:
    parameters: []
    get:
      operationId: games_list
      summary: Get a list of games.
      description: ''
      parameters:
      - name: page
        in: query
        description: A page number within the paginated result set.
        required: false
        schema:
          type: integer
      - name: page_size
        in: query
        description: Number of results to return per page.
        required: false
        schema:
          type: integer
      - name: search
        in: query
        description: Search query.
        schema:
          type: string
      - name: search_precise
        in: query
        description: Disable fuzziness for the search query.
        schema:
          type: boolean
      - name: search_exact
        in: query
        description: Mark the search query as exact.
        schema:
          type: boolean
      - name: parent_platforms
        in: query
        description: 'Filter by parent platforms, for example: `1,2,3`.'
        schema:
          type: string
      - name: platforms
        in: query
        description: 'Filter by platforms, for example: `4,5`.'
        schema:
          type: string
      - name: stores
        in: query
        description: 'Filter by stores, for example: `5,6`.'
        schema:
          type: string
      - name: developers
        in: query
        description: 'Filter by developers, for example: `1612,18893` or `valve-software,feral-interactive`.'
        schema:
          type: string
      - name: publishers
        in: query
        description: 'Filter by publishers, for example: `354,20987` or `electronic-arts,microsoft-studios`.'
        schema:
          type: string
      - name: genres
        in: query
        description: 'Filter by genres, for example: `4,51` or `action,indie`.'
        schema:
          type: string
      - name: tags
        in: query
        description: 'Filter by tags, for example: `31,7` or `singleplayer,multiplayer`.'
        schema:
          type: string
      - name: creators
        in: query
        description: 'Filter by creators, for example: `78,28` or `cris-velasco,mike-morasky`.'
        schema:
          type: string
      - name: dates
        in: query
        description: 'Filter by a release date, for example: `2010-01-01,2018-12-31.1960-01-01,1969-12-31`.'
        schema:
          type: string
      - name: updated
        in: query
        description: 'Filter by an update date, for example: `2020-12-01,2020-12-31`.'
        schema:
          type: string
      - name: platforms_count
        in: query
        description: 'Filter by platforms count, for example: `1`.'
        schema:
          type: integer
      - name: metacritic
        in: query
        description: 'Filter by a metacritic rating, for example: `80,100`.'
        schema:
          type: string
      - name: exclude_collection
        in: query
        description: 'Exclude games from a particular collection, for example: `123`.'
        schema:
          type: integer
      - name: exclude_additions
        in: query
        description: Exclude additions.
        schema:
          type: boolean
      - name: exclude_parents
        in: query
        description: Exclude games which have additions.
        schema:
          type: boolean
      - name: exclude_game_series
        in: query
        description: Exclude games which included in a game series.
        schema:
          type: boolean
      - name: exclude_stores
        in: query
        description: 'Exclude stores, for example: `5,6`.'
        schema:
          type: string
      - name: ordering
        in: query
        description: 'Available fields: `name`, `released`, `added`, `created`, `updated`, `rating`, `metacritic`. You can reverse the sort order adding a hyphen, for example: `-released`.'
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                required:
                - count
                - results
                type: object
                properties:
                  count:
                    type: integer
                  next:
                    type:
                    - string
                    - 'null'
                    format: uri
                  previous:
                    type:
                    - string
                    - 'null'
                    format: uri
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/Game'
      tags:
      - games
  /games/{game_pk}/additions:
    parameters:
    - name: game_pk
      in: path
      required: true
      schema:
        type: string
    get:
      operationId: games_additions_list
      summary: Get a list of DLC's for the game, GOTY and other editions, companion apps, etc.
      description: ''
      parameters:
      - name: page
        in: query
        description: A page number within the paginated result set.
        required: false
        schema:
          type: integer
      - name: page_size
        in: query
        description: Number of results to return per page.
        required: false
        schema:
          type: integer
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                required:
                - count
                - results
                type: object
                properties:
                  count:
                    type: integer
                  next:
                    type:
                    - string
                    - 'null'
                    format: uri
                  previous:
                    type:
                    - string
                    - 'null'
                    format: uri
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/Game'
      tags:
      - games
  /games/{game_pk}/development-team:
    parameters:
    - name: game_pk
      in: path
      required: true
      schema:
        type: string
    get:
      operationId: games_development-team_list
      summary: Get a list of individual creators that were part of the development team.
      description: ''
      parameters:
      - name: ordering
        in: query
        description: Which field to use when ordering the results.
        required: false
        schema:
          type: string
      - name: page
        in: query
        description: A page number within the paginated result set.
        required: false
        schema:
          type: integer
      - name: page_size
        in: query
        description: Number of results to return per page.
        required: false
        schema:
          type: integer
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                required:
                - count
                - results
                type: object
                properties:
                  count:
                    type: integer
                  next:
                    type:
                    - string
                    - 'null'
                    format: uri
                  previous:
                    type:
                    - string
                    - 'null'
                    format: uri
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/GamePersonList'
      tags:
      - games
  /games/{game_pk}/game-series:
    parameters:
    - name: game_pk
      in: path
      required: true
      schema:
        type: string
    get:
      operationId: games_game-series_list
      summary: Get a list of games that are part of the same series.
      description: ''
      parameters:
      - name: page
        in: query
        description: A page number within the paginated result set.
        required: false
        schema:
          type: integer
      - name: page_size
        in: query
        description: Number of results to return per page.
        required: false
        schema:
          type: integer
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                required:
                - count
                - results
                type: object
                properties:
                  count:
                    type: integer
                  next:
                    type:
                    - string
                    - 'null'
                    format: uri
                  previous:
                    type:
                    - string
                    - 'null'
                    format: uri
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/Game'
      tags:
      - games
  /games/{game_pk}/parent-games:
    parameters:
    - name: game_pk
      in: path
      required: true
      schema:
        type: string
    get:
      operationId: games_parent-games_list
      summary: Get a list of parent games for DLC's and editions.
      description: ''
      parameters:
      - name: page
        in: query
        description: A page number within the paginated result set.
        required: false
        schema:
          type: integer
      - name: page_size
        in: query
        description: Number of results to return per page.
        required: false
        schema:
          type: integer
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                required:
                - count
                - results
                type: object
                properties:
                  count:
                    type: integer
                  next:
                    type:
                    - string
                    - 'null'
                    format: uri
                  previous:
                    type:
                    - string
                    - 'null'
                    format: uri
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/Game'
      tags:
      - games
  /games/{game_pk}/screenshots:
    parameters:
    - name: game_pk
      in: path
      required: true
      schema:
        type: string
    get:
      operationId: games_screenshots_list
      summary: Get screenshots for the game.
      description: ''
      parameters:
      - name: ordering
        in: query
        description: Which field to use when ordering the results.
        required: false
        schema:
          type: string
      - name: page
        in: query
        description: A page number within the paginated result set.
        required: false
        schema:
          type: integer
      - name: page_size
        in: query
        description: Number of results to return per page.
        required: false
        schema:
          type: integer
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                required:
                - count
                - results
                type: object
                properties:
                  count:
                    type: integer
                  next:
                    type:
                    - string
                    - 'null'
                    format: uri
                  previous:
                    type:
                    - string
                    - 'null'
                    format: uri
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/ScreenShot'
      tags:
      - games
  /games/{game_pk}/stores:
    parameters:
    - name: game_pk
      in: path
      required: true
      schema:
        type: string
    get:
      operationId: games_stores_list
      summary: Get links to the stores that sell the game.
      description: ''
      parameters:
      - name: ordering
        in: query
        description: Which field to use when ordering the results.
        required: false
        schema:
          type: string
      - name: page
        in: query
        description: A page number within the paginated result set.
        required: false
        schema:
          type: integer
      - name: page_size
        in: query
        description: Number of results to return per page.
        required: false
        schema:
          type: integer
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                required:
                - count
                - results
                type: object
                properties:
                  count:
                    type: integer
                  next:
                    type:
                    - string
                    - 'null'
                    format: uri
                  previous:
                    type:
                    - string
                    - 'null'
                    format: uri
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/GameStoreFull'
      tags:
      - games
  /games/{id}:
    parameters:
    - name: id
      in: path
      description: A unique integer value identifying this Game.
      required: true
      schema:
        type: integer
    get:
      operationId: games_read
      summary: Get details of the game.
      description: ''
      parameters:
      - name: id
        in: path
        description: An ID or a slug identifying this Game.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GameSingle'
      tags:
      - games
  /games/{id}/achievements:
    parameters:
    - name: id
      in: path
      description: A unique integer value identifying this Game.
      required: true
      schema:
        type: integer
    get:
      operationId: games_achievements_read
      summary: Get a list of game achievements.
      description: ''
      parameters:
      - name: id
        in: path
        description: An ID or a slug identifying this Game.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ParentAchievement'
      tags:
      - games
  /games/{id}/movies:
    parameters:
    - name: id
      in: path
      description: A unique integer value identifying this Game.
      required: true
      schema:
        type: integer
    get:
      operationId: games_movies_read
      summary: Get a list of game trailers.
      description: ''
      parameters:
      - name: id
        in: path
        description: An ID or a slug identifying this Game.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Movie'
      tags:
      - games
  /games/{id}/reddit:
    parameters:
    - name: id
      in: path
      description: A unique integer value identifying this Game.
      required: true
      schema:
        type: integer
    get:
      operationId: games_reddit_read
      summary: Get a list of most recent posts from the game's subreddit.
      description: ''
      parameters:
      - name: id
        in: path
        description: An ID or a slug identifying this Game.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Reddit'
      tags:
      - games
  /games/{id}/suggested:
    parameters:
    - name: id
      in: path
      description: A unique integer value identifying this Game.
      required: true
      schema:
        type: integer
    get:
      operationId: games_suggested_read
      summary: Get a list of visually similar games, available only for business and enterprise API users.
      description: ''
      parameters:
      - name: id
        in: path
        description: An ID or a slug identifying this Game.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GameSingle'
      tags:
      - games
  /games/{id}/twitch:
    parameters:
    - name: id
      in: path
      description: A unique integer value identifying this Game.
      required: true
      schema:
        type: integer
    get:
      operationId: games_twitch_read
      summary: Get streams on Twitch associated with the game, available only for business and enterprise API users.
      description: ''
      parameters:
      - name: id
        in: path
        description: An ID or a slug identifying this Game.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Twitch'
      tags:
      - games
  /games/{id}/youtube:
    parameters:
    - name: id
      in: path
      description: A unique integer value identifying this Game.
      required: true
      schema:
        type: integer
    get:
      operationId: games_youtube_read
      summary: Get videos from YouTube associated with the game, available only for business and enterprise API users.
      description: ''
      parameters:
      - name: id
        in: path
        description: An ID or a slug identifying this Game.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Youtube'
      tags:
      - games
components:
  schemas:
    GamePlatformMetacritic:
      type: object
      properties:
        metascore:
          title: Metascore
          type: integer
          readOnly: true
        url:
          title: Url
          type: string
          readOnly: true
          minLength: 1
    Twitch:
      type: object
      properties:
        id:
          title: ID
          type: integer
          readOnly: true
        external_id:
          title: External id
          type: integer
          readOnly: true
        name:
          title: Name
          type: string
          readOnly: true
          minLength: 1
        description:
          title: Description
          type: string
          readOnly: true
          minLength: 1
        created:
          title: Created
          type: string
          format: date-time
          readOnly: true
        published:
          title: Published
          type: string
          format: date-time
          readOnly: true
        thumbnail:
          title: Thumbnail
          type: string
          format: uri
          readOnly: true
          minLength: 1
        view_count:
          title: View count
          type: integer
          readOnly: true
        language:
          title: Language
          type: string
          readOnly: true
          minLength: 1
    Youtube:
      type: object
      properties:
        id:
          title: ID
          type: integer
          readOnly: true
        external_id:
          title: External id
          type: string
          readOnly: true
          minLength: 1
        channel_id:
          title: Channel id
          type: string
          readOnly: true
          minLength: 1
        channel_title:
          title: Channel title
          type: string
          readOnly: true
          minLength: 1
        name:
          title: Name
          type: string
          readOnly: true
          minLength: 1
        description:
          title: Description
          type: string
          readOnly: true
          minLength: 1
        created:
          title: Created
          type: string
          format: date-time
          readOnly: true
        view_count:
          title: View count
          type: integer
          readOnly: true
        comments_count:
          title: Comments count
          type: integer
          readOnly: true
        like_count:
          title: Like count
          type: integer
          readOnly: true
        dislike_count:
          title: Dislike count
          type: integer
          readOnly: true
        favorite_count:
          title: Favorite count
          type: integer
          readOnly: true
        thumbnails:
          title: Thumbnails
          type: object
          readOnly: true
    ScreenShot:
      type: object
      properties:
        id:
          title: ID
          type: integer
          readOnly: true
        image:
          title: Image
          description: An image file with size up to 20 MB.
          type: string
          readOnly: true
          format: uri
        hidden:
          title: Hidden
          description: Set image as hidden or visible.
          type: boolean
          default: false
        width:
          title: Width
          type: integer
          readOnly: true
        height:
          title: Height
          type: integer
          readOnly: true
      example:
        image: '@image.jpg'
        hidden: false
    Game:
      required:
      - rating
      type: object
      properties:
        id:
          title: ID
          type: integer
          readOnly: true
        slug:
          title: Slug
          type: string
          format: slug
          pattern: ^[-a-zA-Z0-9_]+$
          readOnly: true
          minLength: 1
        name:
          title: Name
          type: string
          readOnly: true
          minLength: 1
        released:
          title: Released
          type: string
          format: date
          readOnly: true
        tba:
          title: TBA
          type: boolean
          readOnly: true
        background_image:
          title: Background image
          type: string
          readOnly: true
          format: uri
        rating:
          title: Rating
          type: number
        rating_top:
          title: Rating top
          type: integer
          readOnly: true
        ratings:
          title: Ratings
          type: object
          readOnly: true
        ratings_count:
          title: Ratings count
          type: integer
          readOnly: true
        reviews_text_count:
          title: Reviews text count
          type: string
          readOnly: true
        added:
          title: Added
          type: integer
          readOnly: true
        added_by_status:
          title: Added by status
          type: object
          readOnly: true
        metacritic:
          title: Metacritic
          type: integer
          readOnly: true
        playtime:
          title: Playtime
          description: in hours
          type: integer
          readOnly: true
        suggestions_count:
          title: Suggestions count
          type: integer
          readOnly: true
        updated:
          title: Updated
          type: string
          format: date-time
          readOnly: true
        esrb_rating:
          type:
          - object
          - 'null'
          properties:
            id:
              type: integer
            slug:
              type: string
              enum:
              - everyone
              - everyone-10-plus
              - teen
              - mature
              - adults-only
              - rating-pending
            name:
              type: string
              enum:
              - Everyone
              - Everyone 10+
              - Teen
              - Mature
              - Adults Only
              - Rating Pending
        platforms:
          type: array
          items:
            type: object
            properties:
              platform:
                type: object
                properties:
                  id:
                    type: integer
                  slug:
                    type: string
                  name:
                    type: string
              released_at:
                type:
                - string
                - 'null'
              requirements:
                type:
                - object
                - 'null'
                properties:
                  minimum:
                    type: string
                  recommended:
                    type: string
    ParentAchievement:
      type: object
      properties:
        id:
          title: ID
          type: integer
          readOnly: true
        name:
          title: Name
          type: string
          readOnly: true
          minLength: 1
        description:
          title: Description
          type: string
          readOnly: true
          minLength: 1
        image:
          title: Image
          type: string
          readOnly: true
          format: uri
        percent:
          title: Percent
          type: string
          format: decimal
          readOnly: true
    Reddit:
      type: object
      properties:
        id:
          title: ID
          type: integer
          readOnly: true
        name:
          title: Name
          type: string
          readOnly: true
          minLength: 1
        text:
          title: Text
          type: string
          readOnly: true
          minLength: 1
        image:
          title: Image
          type: string
          format: uri
          readOnly: true
          minLength: 1
        url:
          title: Url
          type: string
          format: uri
          readOnly: true
          minLength: 1
        username:
          title: Username
          type: string
          readOnly: true
          minLength: 1
        username_url:
          title: Username url
          type: string
          format: uri
          readOnly: true
          minLength: 1
        created:
          title: Created
          type: string
          format: date-time
          readOnly: true
    GameStoreFull:
      required:
      - url
      type: object
      properties:
        id:
          title: ID
          type: integer
          readOnly: true
        game_id:
          title: Game id
          type: string
          readOnly: true
        store_id:
          title: Store id
          type: string
          readOnly: true
        url:
          title: Url
          type: string
          format: uri
          maxLength: 500
          minLength: 1
    GameSingle:
      required:
      - rating
      type: object
      properties:
        id:
          title: ID
          type: integer
          readOnly: true
        slug:
          title: Slug
          type: string
          format: slug
          pattern: ^[-a-zA-Z0-9_]+$
          readOnly: true
          minLength: 1
        name:
          title: Name
          type: string
          readOnly: true
          minLength: 1
        name_original:
          title: Name original
          type: string
          readOnly: true
          minLength: 1
        description:
          title: Description
          type: string
          readOnly: true
          minLength: 1
        metacritic:
          title: Metacritic
          type: integer
          readOnly: true
        metacritic_platforms:
          type: array
          items:
            $ref: '#/components/schemas/GamePlatformMetacritic'
          readOnly: true
        released:
          title: Released
          type: string
          format: date
          readOnly: true
        tba:
          title: TBA
          type: boolean
          readOnly: true
        updated:
          title: Updated
          type: string
          format: date-time
          readOnly: true
        background_image:
          title: Background image
          type: string
          readOnly: true
          format: uri
        background_image_additional:
          title: Background image additional
          type: string
          readOnly: true
        website:
          title: Website
          type: string
          format: uri
          readOnly: true
          minLength: 1
        rating:
          title: Rating
          type: number
        rating_top:
          title: Rating top
          type: integer
          readOnly: true
        ratings:
          title: Ratings
          type: object
          readOnly: true
        reactions:
          title: Reactions
          type: object
          readOnly: true
        added:
          title: Added
          type: integer
          readOnly: true
        added_by_status:
          title: Added by status
          type: object
          readOnly: true
        playtime:
          title: Playtime
          description: in hours
          type: integer
          readOnly: true
        screenshots_count:
          title: Screenshots count
          type: integer
          readOnly: true
        movies_count:
          title: Movies count
          type: integer
          readOnly: true
        creators_count:
          title: Creators count
          type: integer
          readOnly: true
        achievements_count:
          title: Achievements count
          type: integer
          readOnly: true
        parent_achievements_count:
          title: Parent achievements count
          type: string
          readOnly: true
        reddit_url:
          title: Reddit url
          description: For example "https://www.reddit.com/r/uncharted/" or "uncharted"
          type: string
          readOnly: true
          minLength: 1
        reddit_name:
          title: Reddit name
          type: string
          readOnly: true
          minLength: 1
        reddit_description:
          title: Reddit description
          type: string
          readOnly: true
          minLength: 1
        reddit_logo:
          title: Reddit logo
          type: string
          format: uri
          readOnly: true
          minLength: 1
        reddit_count:
          title: Reddit count
          type: integer
          readOnly: true
        twitch_count:
          title: Twitch count
          type: string
          readOnly: true
      

# --- truncated at 32 KB (35 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/rawg/refs/heads/main/openapi/rawg-games-api-openapi.yml