Skip to main content
GET
/
v1
/
videos
/
{id}
Get detailed video information by ID
curl --request GET \
  --url https://api.freepik.com/v1/videos/{id} \
  --header 'x-freepik-api-key: <api-key>'
{
  "data": {
    "id": 70000,
    "url": "https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667335",
    "name": "Cute cat looking at the camera",
    "aspect-ratio": "16:9",
    "created": "2019-01-01T00:00:00.000Z",
    "code": "cute-cat-looking-camera",
    "quality": "720p",
    "premium": true,
    "duration": "00:25",
    "author": {
      "id": 23,
      "name": "Freepik",
      "code": "freepik",
      "avatar": "https://avatar.cdnpk.net/23.jpg",
      "metas": {
        "downloads": 555,
        "assets": 2330000
      },
      "slug": "freepik"
    },
    "thumbnails": [
      {
        "width": 468,
        "height": 264,
        "url": "https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg",
        "aspect-ratio": "16:9"
      },
      {
        "width": 1280,
        "height": 720,
        "url": "https://v4.cdnpk.net/videvo_files/video/free/video0467/thumbnails/_import_615163540096e1.68968110_large.jpg",
        "aspect-ratio": "16:9"
      }
    ],
    "previews": [
      {
        "width": 468,
        "height": 264,
        "url": "https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61b436a9c16290.44924640_small.jpg",
        "aspect-ratio": "16:9"
      }
    ],
    "active": true,
    "is_ai_generated": false,
    "item_subtype": "footage"
  }
}

Authorizations

​
x-freepik-api-key
string
header
required

Your Freepik API key. Required for authentication. Learn how to obtain an API key

Headers

​
Accept-Language
string

Specifies the search query language using the ISO 639-1 (2-letter language code) and the ISO 3166-1 (2-letter country code) for language variants. The API will use "en-US" as a default language for processing if a code is not provided, or does not exist.

Path Parameters

​
id
integer
required

Video id

Required range: x >= 1

Response

OK

​
data
object
Example:
{
  "aspect_ratio": "969",
  "code": "gorgeous-woman-stretching-neck",
  "created": "2000-01-23T04:56:07.000Z",
  "author": {
    "metas": { "assets": 0, "downloads": 0 },
    "code": "merry-christmas",
    "name": "John Doe",
    "id": 2147483647,
    "avatar": "https://avatar.cdnpk.net/61668527-220726032514.jpg",
    "slug": "merry-christmas"
  },
  "fps": "25",
  "active": 1,
  "url": "https://www.freepik.com/free-video/white-t-shirts-copy-space-gray-background_15667327",
  "quality": "4k",
  "tags": [
    {
      "name": "Merry Christmas",
      "slug": "merry-christmas"
    },
    {
      "name": "Merry Christmas",
      "slug": "merry-christmas"
    }
  ],
  "duration": "00:00:28",
  "explicit": 0,
  "premium": 0,
  "is_ai_generated": true,
  "item_subtype": "footage",
  "name": "gorgeous woman stretching neck",
  "previews": [
    {
      "url": "https://v1.cdnpk.net/videvo_files/video/premium/video0289/watermarked/_Geometric80s30_FPpreview.mp4",
      "width": 100,
      "height": 100,
      "aspect_ratio": "16:9"
    },
    {
      "url": "https://v1.cdnpk.net/videvo_files/video/premium/video0289/watermarked/_Geometric80s30_FPpreview.mp4",
      "width": 100,
      "height": 100,
      "aspect_ratio": "16:9"
    }
  ],
  "options": [
    {
      "id": 76989,
      "active": true,
      "width": 4096,
      "height": 2304,
      "quality": "4k",
      "container": "mp4",
      "codec": "AVC Coding",
      "bit_rate": 25.44,
      "size": 400,
      "aspect_ratio": "16:9",
      "is_original": true
    },
    {
      "id": 76989,
      "active": true,
      "width": 4096,
      "height": 2304,
      "quality": "4k",
      "container": "mp4",
      "codec": "AVC Coding",
      "bit_rate": 25.44,
      "size": 400,
      "aspect_ratio": "16:9",
      "is_original": true
    }
  ],
  "id": 99332243,
  "thumbnails": [
    {
      "url": "https://img.freepik.com/free-photo/image_8353-7579.jpg",
      "width": 100,
      "height": 100,
      "aspect_ratio": "16:9"
    },
    {
      "url": "https://img.freepik.com/free-photo/image_8353-7579.jpg",
      "width": 100,
      "height": 100,
      "aspect_ratio": "16:9"
    }
  ]
}