> ## Documentation Index
> Fetch the complete documentation index at: https://docs.streamforge.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get multiple games

> Fetch multiple games by platform-specific game IDs or IGDB IDs in a single request.
Accepts up to 100 game IDs.

- For Twitch: provide Twitch game IDs
- For YouTube: provide YouTube game channel IDs
- For IGDB: provide IGDB game IDs directly




## OpenAPI

````yaml POST /platforms/{platform}/games
openapi: 3.0.3
info:
  title: Streamforge External API
  description: >
    Public-facing API for accessing normalized creator, content, and analysis
    data across Twitch, YouTube, Instagram, and TikTok.


    ## Authentication

    All requests require an API key in the `x-api-key` header.


    ## Rate Limiting

    The API uses a weight-based quota system:

    - Single item requests: 1 quota unit

    - Bulk requests: 1 quota unit per item (up to 100 items)

    - List requests: 1 quota unit per item returned (based on `limit`)

    - Advanced endpoint: 100 quota units per request


    Rate limit headers are included in all responses:

    - `X-RateLimit-{window}-limit`: Maximum requests allowed

    - `X-RateLimit-{window}-remaining`: Remaining requests

    - `X-RateLimit-{window}-reset`: ISO timestamp when limit resets


    ### Quota weights by endpoint:

    - Profile/Content endpoints: 1 quota unit per item

    - Analysis endpoint: 100 quota units per request

    - Email endpoint: 10 quota units per request

    - Socials endpoint: 10 quota units per request

    - Audience endpoint: 100 quota units per request


    ## Base URL

    Production: `https://external-api.streamforge.com`
  version: 1.0.0
  contact:
    name: Streamforge Support
    email: support@streamforge.com
servers:
  - url: https://external-api.streamforge.com
    description: Production
  - url: http://localhost:3000
    description: Local development (from .env)
    variables:
      base_url:
        default: http://localhost:3000
security:
  - ApiKeyAuth: []
tags:
  - name: Health
    description: Health check endpoint
  - name: Profiles
    description: Creator profile endpoints
  - name: Content
    description: Content (streams/videos) endpoints
  - name: Games
    description: Game metadata endpoints
  - name: Advanced
    description: Advanced insights and analysis
paths:
  /platforms/{platform}/games:
    post:
      tags:
        - Games
      summary: Get multiple games
      description: >
        Fetch multiple games by platform-specific game IDs or IGDB IDs in a
        single request.

        Accepts up to 100 game IDs.


        - For Twitch: provide Twitch game IDs

        - For YouTube: provide YouTube game channel IDs

        - For IGDB: provide IGDB game IDs directly
      operationId: bulkGetGames
      parameters:
        - name: platform
          in: path
          required: true
          description: Platform identifier (twitch, youtube, or igdb)
          schema:
            type: string
            enum:
              - twitch
              - youtube
              - igdb
            example: twitch
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - game_ids
              properties:
                game_ids:
                  type: array
                  items:
                    type: string
                  minItems: 1
                  maxItems: 100
                  example:
                    - '2011938005'
                    - '491487'
                    - '490377'
      responses:
        '200':
          description: Games found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BulkGameResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/TooManyRequests'
components:
  schemas:
    BulkGameResponse:
      type: object
      properties:
        payload:
          type: array
          items:
            $ref: '#/components/schemas/Game'
        meta:
          allOf:
            - $ref: '#/components/schemas/Meta'
            - type: object
              properties:
                missing_ids:
                  type: array
                  items:
                    type: string
    Game:
      type: object
      properties:
        id:
          type: string
          description: IGDB game ID
          example: '189165'
        name:
          type: string
          nullable: true
          example: Kill The Monster Z
        slug:
          type: string
          nullable: true
          example: kill-the-monster-z
        first_release_date:
          type: string
          format: date-time
          nullable: true
          description: First release date in ISO 8601 format
          example: '2017-03-01T00:00:00.000Z'
        twitch_id:
          type: string
          nullable: true
          description: Twitch game ID (only present if game is available on Twitch)
          example: '2011938005'
        youtube_id:
          type: string
          nullable: true
          description: >-
            YouTube game channel ID (only present if game is available on
            YouTube)
          example: UCf_7CrLpgmot2vPKYwx5zQg
    Meta:
      type: object
      properties:
        source:
          type: string
        received_at:
          type: string
          format: date-time
        request_id:
          type: string
          format: uuid
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            status:
              type: integer
            message:
              type: string
        meta:
          type: object
          properties:
            request_id:
              type: string
              format: uuid
  responses:
    BadRequest:
      description: Bad request - validation error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              status: 400
              message: Invalid platform or missing required parameter
            meta:
              request_id: 5e7c0137-1ed3-4b4b-8e5f-3d9cf00f7ac4
    Unauthorized:
      description: Missing API key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              status: 401
              message: API key is required
            meta:
              request_id: 5e7c0137-1ed3-4b4b-8e5f-3d9cf00f7ac4
    Forbidden:
      description: Invalid or revoked API key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              status: 403
              message: Invalid API key
            meta:
              request_id: 5e7c0137-1ed3-4b4b-8e5f-3d9cf00f7ac4
    TooManyRequests:
      description: Rate limit exceeded
      headers:
        Retry-After:
          schema:
            type: integer
          description: Seconds until retry is safe
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              status: 429
              message: Rate limit exceeded
            meta:
              request_id: 5e7c0137-1ed3-4b4b-8e5f-3d9cf00f7ac4
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: |
        Your API key. Include it in the `x-api-key` header for all requests.

````