VideoVerse

VideoVerse Match Video API

The Match Video API from VideoVerse — 2 operation(s) for match video.

Documentation GitHub OpenAPI

Operations 2

GET /v1/match-video/{matchVideoId} Get match video by matchVideoId #

GET /v1/match-video Get all match videos #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/videoverse-match-video-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Magnifi Partner Integration Match Video API
  version: v1
  summary: Partner API for Magnifi by VideoVerse — stream ingestion, AI clip and highlight retrieval, roster and match-schedule management, and webhook subscriptions.
  description: Magnifi offers a comprehensive suite of API endpoints designed for seamless integration, enabling partners to access platform resources, content, and metadata efficiently.
  contact:
    name: Magnifi by VideoVerse
    url: https://magnifi.ai/contact-us
  termsOfService: https://magnifi.ai/terms-conditions
servers:
- url: '{PARTNER_BASE_URL}'
  description: Templated. Magnifi publishes its partner API base only as the Postman variable {{PARTNER_BASE_URL}}; the concrete host is issued to each partner alongside the Access Key and Access Secret and is not stated in the public documentation.
  variables:
    PARTNER_BASE_URL:
      default: '{PARTNER_BASE_URL}'
      description: Partner-specific API base URL issued by Magnifi.
security:
- AccessKey: []
  AccessSecret: []
tags:
- name: Match Video
paths:
  /v1/match-video/{matchVideoId}:
    get:
      operationId: getMatchVideoByMatchVideoId
      summary: Get match video by matchVideoId
      tags:
      - Match Video
      description: 'Retrieves match video information based on the matchVideoId.

        Params:


        MATCH_VIDEO_ID (URL param): Specifies the unique identifier of the match video to fetch.'
      parameters:
      - name: matchVideoId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                  message:
                    type: string
                  data:
                    type: object
                    properties:
                      matchVideoId:
                        type: string
                      type:
                        type: string
                      streamId:
                        type: string
                      status:
                        type: string
                      matchVideoTitle:
                        type: string
                      startTime:
                        type: string
                      endTime:
                        type: string
                      progress:
                        type: integer
                      createdAt:
                        type: string
                        format: date-time
                      updatedAt:
                        type: string
                        format: date-time
                      isActive:
                        type: boolean
              examples:
                getMatchVideoByMatchVideoId:
                  value:
                    statusCode: 200
                    message: Match video retrieved successfully
                    data:
                      matchVideoId: 994d9541-4294-9803-9238-9ac03c97e117
                      type: partial-video
                      streamId: RDP08FBIV
                      status: COMPLETED
                      matchVideoTitle: custom duration
                      startTime: 00:00:00
                      endTime: 00:02:34
                      progress: 100
                      createdAt: '2025-11-12T08:25:36.117Z'
                      updatedAt: '2025-11-12T08:26:29.943Z'
                      isActive: true
        '401':
          description: Unauthorized — invalid or missing x-access-key / x-access-secret.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthError'
        default:
          description: Error response carrying a Magnifi error code.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /v1/match-video:
    get:
      operationId: getAllMatchVideos
      summary: Get all match videos
      tags:
      - Match Video
      description: 'Retrieves a list of all match videos.

        Query Params:


        type (enum, optional): partial-video | full-video.


        status (enum, optional): INITIATED | PROCESSING | COMPLETED | FAILED.


        search (string, optional): Searches for match video by title.


        sort (number, optional): -1 = Newest, 1 = Oldest. By default, items are sorted by newest.


        page (number, required): The page number to retrieve.


        pageSize (number, required): The number of items per page.'
      parameters:
      - name: search
        in: query
        required: false
        schema:
          type: string
        example: export
      - name: type
        in: query
        required: false
        schema:
          type: string
        example: partial-video
      - name: status
        in: query
        required: false
        schema:
          type: string
        example: COMPLETED
      - name: sort
        in: query
        required: false
        schema:
          type: integer
        example: '-1'
      - name: page
        in: query
        required: false
        schema:
          type: integer
        example: '1'
      - name: pageSize
        in: query
        required: false
        schema:
          type: integer
        example: '10'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                  message:
                    type: string
                  data:
                    type: object
                    properties:
                      matchVideos:
                        type: array
                        items:
                          type: object
                          properties:
                            matchVideoId:
                              type: string
                            matchVideoTitle:
                              type: string
                            streamId:
                              type: string
                            startTime:
                              type: string
                            endTime:
                              type: string
                            status:
                              type: string
                            type:
                              type: string
                            progress:
                              type: integer
                            createdAt:
                              type: string
                              format: date-time
                            updatedAt:
                              type: string
                              format: date-time
                            isActive:
                              type: boolean
                      currentPage:
                        type: integer
                      pageSize:
                        type: integer
                      totalItems:
                        type: integer
                      totalPages:
                        type: integer
              examples:
                getAllMatchVideos:
                  value:
                    statusCode: 200
                    message: Match videos retrieved successfully
                    data:
                      matchVideos:
                      - matchVideoId: 9f8bd385-4ebe-b2f2-c5b6-45fbe5e7917a
                        matchVideoTitle: First Example
                        streamId: pfXngzUvzA
                        startTime: 00:10:00
                        endTime: 00:20:00
                        status: COMPLETED
                        type: partial-video
                        progress: 100
                        createdAt: '2026-03-27T09:26:08.759Z'
                        updatedAt: '2026-03-27T09:27:16.130Z'
                        isActive: true
                      - matchVideoId: a169320e-b7b0-c221-4076-e23b333ccbb4
                        matchVideoTitle: Second Example
                        streamId: pfXngzUvzA
                        startTime: 00:00:00
                        endTime: 00:27:19
                        status: COMPLETED
                        type: full-video
                        progress: 100
                        createdAt: '2026-03-27T09:25:54.463Z'
                        updatedAt: '2026-03-27T09:27:27.608Z'
                        isActive: true
                      currentPage: 1
                      pageSize: 10
                      totalItems: 2
                      totalPages: 1
        '401':
          description: Unauthorized — invalid or missing x-access-key / x-access-secret.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthError'
        default:
          description: Error response carrying a Magnifi error code.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      type: object
      description: Magnifi error envelope. `error.code` is a Magnifi error code (see errors/videoverse-problem-types.yml).
      properties:
        statusCode:
          type: integer
        error:
          type: object
          properties:
            message:
              type: string
            code:
              type: string
            metadata:
              type: object
      example:
        statusCode: 404
        error:
          message: Clip data not found
          code: C001
          metadata: {}
    AuthError:
      type: object
      description: Returned when the access key or secret is missing or invalid.
      properties:
        message:
          type: string
        error:
          type: string
        statusCode:
          type: integer
      example:
        message: Invalid access key or access secret
        error: Unauthorized
        statusCode: 401
  securitySchemes:
    AccessKey:
      type: apiKey
      in: header
      name: x-access-key
      description: 'Partner Access Key issued by Magnifi. Documented example prefix: pak_.'
    AccessSecret:
      type: apiKey
      in: header
      name: x-access-secret
      description: Partner Access Secret issued by Magnifi. Sent on every request alongside x-access-key.
externalDocs:
  description: Magnifi x Partner Integration Documentation
  url: https://docs.prod.videoverse.dev/
x-generated-from: postman-collection
x-source: https://documenter.gw.postman.com/api/collections/34141959/2sA3s6EpXt?segregateAuth=true&versionTag=latest
x-generated-by: API Evangelist enrichment pipeline (local-v3)
x-generated-on: '2026-09-04'