openapi: 3.1.0
info:
  title: Twitch Drops Ads Ingest API
  description: APIs for game developers to create and manage Drops campaigns that grant in-game rewards to Twitch viewers watching streamers play their game. Drops campaigns are managed through the Twitch Developer Console and fulfilled via the Helix API entitlements endpoints.
  version: '1.0'
  contact:
    name: Twitch Developer Support
    url: https://dev.twitch.tv/support/
  termsOfService: https://www.twitch.tv/p/legal/terms-of-service/
servers:
- url: https://api.twitch.tv/helix
  description: Twitch Helix API Production
security:
- oauth2: []
tags:
- name: Ingest
  description: Ingest server information for broadcasting
paths:
  /api/v2/ingests:
    get:
      operationId: getIngests
      summary: Twitch Get Ingest Servers
      description: Gets a list of Twitch ingest servers for broadcasting. Returns servers sorted by proximity to the requester. Broadcasters should connect to the lowest-numbered available server.
      tags:
      - Ingest
      responses:
        '200':
          description: Ingest servers returned successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  ingests:
                    type: array
                    items:
                      $ref: '#/components/schemas/IngestServer'
components:
  schemas:
    IngestServer:
      type: object
      properties:
        _id:
          type: integer
          description: Unique identifier for the ingest server
        availability:
          type: number
          format: float
          description: Availability score of the server (1.0 means available)
        default:
          type: boolean
          description: Whether this is the recommended default server
        name:
          type: string
          description: Human-readable name of the ingest location
        url_template:
          type: string
          description: RTMP URL template for the ingest server. Replace {stream_key} with the broadcaster's stream key.
        url_template_secure:
          type: string
          description: Secure RTMPS URL template for the ingest server. Replace {stream_key} with the broadcaster's stream key.
        priority:
          type: integer
          description: Priority ranking of the server (lower is higher priority)
  securitySchemes:
    oauth2:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: https://id.twitch.tv/oauth2/token
          scopes: {}
externalDocs:
  description: Twitch Drops Documentation
  url: https://dev.twitch.tv/docs/drops/