---
title: "Search and filter videos by specified order"
method: GET
path: "/v1/videos"
tags: ["Videos"]
---

# Search and filter videos by specified order

`GET /v1/videos`

## Request

- Base URL: `https://api.magnific.com`
- URL: `https://api.magnific.com/v1/videos`
- Auth: API key in header `x-magnific-api-key`

## Query parameters

- `term` string, required
- `page` integer
- `order` 'relevance' | 'recent' | 'random'
- `filters` V1VideosGetFiltersParameter
  - `aspect_ratio` string[]
  - `category` 'footage' | 'motion_graphics'
  - `duration` V1VideosGetFiltersParameterDuration
    - `from` integer
    - `to` integer
  - `orientation` string[]
  - `license` V1VideosGetFiltersParameterLicense
    - `free` boolean
    - `premium` boolean
  - `resolution` V1VideosGetFiltersParameterResolution
    - `720` boolean
    - `1080` boolean
    - `2k` boolean
    - `4k` boolean
  - `fps` string[]
  - `topic` string[]
  - `ai-generated` V1VideosGetFiltersParameterAiGenerated
    - `excluded` boolean
    - `only` boolean
  - `video-tool` V1VideosGetFiltersParameterVideoTool
    - `after-effects` boolean
    - `premiere-pro` boolean
    - `mogrt` boolean
  - `ids` string
  - `author` integer

## Headers

- `Accept-Language` string

## Response `200`

OK

- V1VideosGet200Response
  - `data` SearchItem[]
    - `id` integer
    - `url` string, uri: Url to the video's detail page in magnific
    - `name` string
    - `aspect_ratio` '4:3' | '16:9' | '256:135' | '9:16' | '1:1': The aspect ratio of this item
    - `created` string, date-time: The datetime when this video was created.
    - `code` string
    - `quality` '720p' | '1080p' | '2k' | '4k': The quality of this video
    - `duration` string
    - `author` AuthorVideo
      - `id` integer, required
      - `name` string, required
      - `code` string
      - `avatar` string, uri, required
      - `metas` AuthorVideoMetas, required
        - `downloads` integer, required: The number of downloads of this author.
        - `assets` integer, required: The number of assets of this author.
      - `slug` string, required
    - `thumbnails` ImageWithAspectRatio[]
      - `url` string, uri, required: The url of the image.
      - `width` integer, required: The width of the image.
      - `height` integer, required: The height of the image.
      - `aspect_ratio` '4:3' | '16:9' | '256:135' | '9:16' | '1:1', required: The aspect ratio of this item
    - `previews` PreviewWithAspectRatio[]
      - `url` string, uri, required: Resource's url.
      - `width` integer, required: Resource image width.
      - `height` integer, required: Resource image height.
      - `aspect_ratio` '4:3' | '16:9' | '256:135' | '9:16' | '1:1', required: The aspect ratio of this item
    - `active` boolean: True if this video is active. False, otherwise.
    - `is_ai_generated` boolean: True if the resource is generated by AI, false otherwise.
    - `item_subtype` 'footage' | 'motion_graphics' | 'other' | 'template' | 'template_aep' | 'template_prproj': The subtype of the video.
    - `premium` integer: 1 if this video is premium. 0, otherwise.
    - `best_asset_for_ai` integer: The id of the best asset for AI (mp4 with best resolution assets option-id).
  - `meta` SearchIcons200ResponseMeta
    - `pagination` Pagination, required: Metainformation about pagination
      - `current_page` integer: The current page.
      - `per_page` integer: The limit of resources per page.
      - `last_page` integer: The total number of pages.
      - `total` integer: The total number of resources.

## Other responses

- `400`: Bad Request - The server could not understand the request due to invalid syntax.
- `404`: Not Found
- `500`: Internal Server Error - The server has encountered a situation it doesn't know how to handle.

---

[API](https://skmtc.dev/magnific/apis/magnific-api.md) · [All operations](https://skmtc.dev/magnific/apis/magnific-api/llms.txt) · [OpenAPI document](https://skmtc.dev/magnific/apis/magnific-api/revisions/60711fb082c7?raw)