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

# Media Segments

> Отримує часові мітки заставок та титрів для автоматичного або ручного пропуску з баз AniSkip та TheIntroDB.



## OpenAPI

````yaml GET /api/segments
openapi: 3.0.3
info:
  title: UAFilms API
  description: >-
    API агрегатора українського медіа-контенту та OMSS (Open Media Streaming
    Specification) стрімінговий сервер з підтримкою HLS проксі, динамічного
    Server-Sent Events (SSE) парсингу, системи акаунтів та персональних
    API-ключів.
  version: 1.2.0
servers:
  - url: https://films.aartzz.pp.ua
    description: Production Server
  - url: http://localhost:3000
    description: Local Development Server
security: []
paths:
  /api/segments:
    get:
      summary: Сегменти пропуску (Intro/Outro/Recap)
      description: >-
        Отримує часові мітки заставок та титрів для автоматичного або ручного
        пропуску з баз AniSkip та TheIntroDB.
      parameters:
        - name: id
          in: query
          description: TMDB ID або IMDB ID
          required: false
          schema:
            type: string
            example: '284445'
        - name: imdb_id
          in: query
          description: IMDB ID (tt...)
          required: false
          schema:
            type: string
            example: tt1234567
        - name: type
          in: query
          description: movie або tv
          required: false
          schema:
            type: string
            enum:
              - movie
              - tv
            default: tv
        - name: season
          in: query
          description: Номер сезону
          required: false
          schema:
            type: integer
            example: 1
        - name: episode
          in: query
          description: Номер серії
          required: false
          schema:
            type: integer
            example: 1
        - name: duration_ms
          in: query
          description: Тривалість відео в мілісекундах для точної синхронізації
          required: false
          schema:
            type: number
            example: 1420000
      responses:
        '200':
          description: Список знайдених сегментів
          content:
            application/json:
              schema:
                type: object
                properties:
                  segments:
                    type: array
                    items:
                      $ref: '#/components/schemas/MediaSegment'
components:
  schemas:
    MediaSegment:
      type: object
      properties:
        type:
          type: string
          enum:
            - intro
            - credits
            - recap
            - preview
          example: intro
        start:
          type: number
          example: 90.5
        end:
          type: number
          example: 175.2
        label:
          type: string
          example: Заставка
        source:
          type: string
          example: theintrodb

````