AI.TV API

openapi: 3.1.0
info:
  title: AI.TV API
  version: '2026-11-01'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-01: 2 operation(s) read from 1 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; AI.TV has published no machine-readable contract that the pipeline
    could find. Engine: oss.'
  x-evidence-tiers:
    code-example: 1
    documentation: 1
    pages-with-code: 1
    pages-read: 1
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-01'
  x-generator: generate-contract-from-docs.py
  x-engine: oss
  x-sources:
  - https://ai.tv/developers/api-doc
servers:
- url: https://api.ai.tv
paths:
  /videos:
    get:
      operationId: get_videos
      tags:
      - Videos
      summary: GET /videos
      x-source: https://ai.tv/developers/api-doc
      parameters:
      - name: maxResults
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetVideosResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X GET 'https://api.ai.tv/videos/?maxResults=5' -H 'Accept: application/json'\nResponse samples\n200\nContent type\napplication/json\n\
          Copy\nExpand allCollapse all\n{\n\"nextPageToken\": \"821JunaY\",\n\"prevPageToken\": \"ZabJqpaY\",\n\"pageInfo\": \n{\n\"totalResults\"\
          : 1000,\n\"resultPerPage\": 10\n},\n\"items\": \n[\n{}\n]\n}"
  /videos/:
    get:
      operationId: get_videos
      tags:
      - Videos
      summary: Retrieve videos
      description: Endpoint for fetching, filtering, and managing video data.
      x-source: https://ai.tv/developers/api-doc
      parameters:
      - name: order
        in: query
        required: false
        schema:
          type: string
        description: 'Sort option for videos. Default: "recent". Enum: "recent", "oldest", "popular", "reaction".'
      - name: id
        in: query
        required: false
        schema:
          type: string
        description: Video id (22 characters).
      - name: channelId
        in: query
        required: false
        schema:
          type: string
        description: Channel id (22 characters).
      - name: channelIds
        in: query
        required: false
        schema:
          type: array
        description: Retrieve videos from multiple channels in a single request. Array of strings (22 characters each).
      - name: categoryId
        in: query
        required: false
        schema:
          type: string
        description: Retrieve videos by category.
      - name: categoryIds
        in: query
        required: false
        schema:
          type: array
        description: Retrieve videos by multiple categories.
      - name: type
        in: query
        required: false
        schema:
          type: string
        description: 'Video type filter. Enum: "short", "video".'
      - name: maxResults
        in: query
        required: false
        schema:
          type: integer
        description: 'Maximum number of results to return. Default: 10.'
      - name: pageToken
        in: query
        required: false
        schema:
          type: string
        description: Token for pagination (>= 8 characters).
      - name: playlistId
        in: query
        required: false
        schema:
          type: string
        description: Playlist identifier (>= 8 characters).
      - name: uploadState
        in: query
        required: false
        schema:
          type: string
        description: 'Upload state filter. Enum: "created", "uploading", "uploaded", "processing", "processed", "failed", "rejected", "aborted",
          "completed".'
      - name: privacySettings
        in: query
        required: false
        schema:
          type: array
        description: 'Visibility type filter. Array of strings. Items enum: "paid", "public", "private".'
      - name: format
        in: query
        required: false
        schema:
          type: string
        description: 'Response format. Default: "json". Enum: "json", "xml".'
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetVideosResponse2'
      x-evidence:
        kind: documentation
components:
  schemas:
    GetVideosResponse:
      type: object
      properties:
        nextPageToken:
          type: string
        prevPageToken:
          type: string
        pageInfo:
          type: object
          properties:
            totalResults:
              type: integer
            resultPerPage:
              type: integer
        items:
          type: array
          items:
            type: object
    GetVideosResponse2:
      type: object
      properties:
        nextPageToken:
          type: string
          description: Token for the next page of results.
        prevPageToken:
          type: string
          description: Token for the previous page of results.
        pageInfo:
          type: object
          description: Pagination information.
        items:
          type: array
          description: Array of video objects.
tags:
- name: Videos