---
updatedAt: 2026-11-11T07:32:40.000Z
agentTools:
  projectIndex: https://docs.yotpo.com/llms.txt
---

# Import videos

Use this endpoint to import videos to Yotpo's Visual Curation. Videos can be added to Custom Albums and Product Albums by including `videos.album_names` and `videos.domain_keys`, respectively.

> 👍 How to use this endpoint
>
> * For example responses, click the relevant status code on the right.

> 🚧 Video format limitations:
>
> * This endpoint supports all video formats with the exception of MKV video containers.
> * Video files must be under 2GB in size.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Reviews API (V1)",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api.yotpo.com",
      "description": "Main API server for authenticated and write operations"
    }
  ],
  "components": {
    "securitySchemes": {
      "X-Yotpo-Token": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Yotpo-Token",
        "description": "Your Yotpo account access token. See [Yotpo Authentication](ref:yotpo-authentication) to learn how to generate your token."
      }
    },
    "responses": {
      "Unauthorized": {
        "description": "Missing or invalid access token",
        "content": {
          "application/json": {
            "examples": {
              "Unauthorized": {
                "value": {
                  "status": {
                    "message": "You are not authorized to access this page.",
                    "code": 401,
                    "error_type": "Exceptions::AccessDenied"
                  }
                }
              }
            },
            "schema": {
              "type": "object",
              "properties": {
                "status": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "description": "Human-readable error message"
                    },
                    "code": {
                      "type": "integer",
                      "description": "HTTP status code"
                    },
                    "error_type": {
                      "type": "string",
                      "description": "Internal error class"
                    }
                  },
                  "description": "Error details."
                }
              }
            }
          }
        }
      }
    }
  },
  "security": [
    {
      "X-Yotpo-Token": []
    }
  ],
  "paths": {
    "/v1/media_upload/video_bulk_upload": {
      "post": {
        "summary": "Import videos",
        "description": "Use this endpoint to import videos to Yotpo's Visual Curation. Videos can be added to Custom Albums and Product Albums by including `videos.album_names` and `videos.domain_keys`, respectively.",
        "operationId": "import-videos",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "app_key",
                  "videos"
                ],
                "properties": {
                  "app_key": {
                    "type": "string",
                    "description": "Your store ID (app key)."
                  },
                  "videos": {
                    "type": "array",
                    "description": "Videos array containing video metadata.",
                    "items": {
                      "type": "object",
                      "required": [
                        "source",
                        "url"
                      ],
                      "properties": {
                        "source": {
                          "type": "string",
                          "description": "The source of the video upload."
                        },
                        "url": {
                          "type": "string",
                          "description": "The hosted video URL."
                        },
                        "user_name": {
                          "type": "string",
                          "description": "The uploader's user_name."
                        },
                        "user_email": {
                          "type": "string",
                          "description": "The user email address."
                        },
                        "caption": {
                          "type": "string",
                          "description": "The textual caption that appears within the video lightbox."
                        },
                        "creation_date": {
                          "type": "string",
                          "description": "The video creation timestamp.",
                          "format": "date"
                        },
                        "album_names": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "description": "Include album names to add videos to existing Custom Albums. Entirely new Custom Albums can be created by adding new album names."
                        },
                        "domain_keys": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "description": "Tag products that appear in videos to automatically display them in product albums. Each video can be tagged with a maximum of 8 `domain_keys` (Product IDs)."
                        }
                      }
                    }
                  }
                }
              },
              "examples": {
                "JSON": {
                  "value": {
                    "app_key": "YOUR_STORE_ID",
                    "videos": [
                      {
                        "source": "import",
                        "url": "https://sample-videos.com/video123/mp4/720/sunglasses_video.mp4",
                        "user_name": "user_name",
                        "user_email": "user@example.com",
                        "caption": "video_caption",
                        "creation_date": "2019-01-22",
                        "album_names": [
                          "cats",
                          "kittens",
                          "cats_of_instagram"
                        ],
                        "domain_keys": [
                          "354582790180",
                          "354581544996",
                          "354583674916",
                          "354581544996"
                        ]
                      }
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"message\": \"You can track the upload status of each video in this link http://www.kaltura.com/api_v3/service/bulkUpload/action/serveLog/id/9476725731/ks/djJ8MjQ1ODEyMnyEE5rj8mzZu-rqS9uQ6PyhAANrGdk_tSO7bznaR899dwHKz2IaKQWTscxGZcNd4WE_t5W8N2uqMdC09ezPhT82. Expires in: 72 hours \",\n    \"log_file\": \"http://www.kaltura.com/api_v3/service/bulkUpload/action/serveLog/id/9476725731/ks/djJ8MjQ1ODEyMnyEE5rj8mzZu-rqS9uQ6PyhAANrGdk_tSO7bznaR899dwHKz2IaKQWTscxGZcNd4WE_t5W8N2uqMdC09ezPhT82\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "example": "You can track the upload status of each video in this link http://www.kaltura.com/api_v3/service/bulkUpload/action/serveLog/id/9476725731/ks/djJ8MjQ1ODEyMnyEE5rj8mzZu-rqS9uQ6PyhAANrGdk_tSO7bznaR899dwHKz2IaKQWTscxGZcNd4WE_t5W8N2uqMdC09ezPhT82. Expires in: 72 hours ",
                      "description": "Status message."
                    },
                    "log_file": {
                      "type": "string",
                      "example": "http://www.kaltura.com/api_v3/service/bulkUpload/action/serveLog/id/9476725731/ks/djJ8MjQ1ODEyMnyEE5rj8mzZu-rqS9uQ6PyhAANrGdk_tSO7bznaR899dwHKz2IaKQWTscxGZcNd4WE_t5W8N2uqMdC09ezPhT82"
                    }
                  }
                }
              }
            },
            "headers": {
              "ratelimit-limit": {
                "description": "The maximum number of requests allowed in the current time window",
                "schema": {
                  "type": "integer"
                }
              },
              "ratelimit-remaining": {
                "description": "The number of requests remaining in the current time window",
                "schema": {
                  "type": "integer"
                }
              },
              "ratelimit-reset": {
                "description": "The time (in seconds) until the rate limit resets",
                "schema": {
                  "type": "integer"
                }
              },
              "x-ratelimit-limit-minute": {
                "description": "The maximum number of requests allowed per minute",
                "schema": {
                  "type": "integer"
                }
              },
              "x-ratelimit-remaining-minute": {
                "description": "The number of requests remaining in the current minute",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            },
            "headers": {
              "ratelimit-limit": {
                "description": "The maximum number of requests allowed in the current time window",
                "schema": {
                  "type": "integer"
                }
              },
              "ratelimit-remaining": {
                "description": "The number of requests remaining in the current time window",
                "schema": {
                  "type": "integer"
                }
              },
              "ratelimit-reset": {
                "description": "The time (in seconds) until the rate limit resets",
                "schema": {
                  "type": "integer"
                }
              },
              "x-ratelimit-limit-minute": {
                "description": "The maximum number of requests allowed per minute",
                "schema": {
                  "type": "integer"
                }
              },
              "x-ratelimit-remaining-minute": {
                "description": "The number of requests remaining in the current minute",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [
      {
        "value": "application/json",
        "key": "Content-Type"
      }
    ],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```