Skip to main content
GET
Get Generated Videos

Overview

This endpoint retrieves a paginated list of all AI-generated videos associated with your account. The results are sorted by creation date in descending order, with the most recent videos returned first. Each item includes the video URL, prompt, model, dimensions, duration, thumbnail images, and other metadata from the original generation request.
A valid API key is required to use this endpoint. Obtain your API key from the API Access page in your Pictory dashboard.

API Endpoint


Request Parameters

Headers

Authorization
string
required
API key for authentication (starts with pictai_)

Query Parameters

nextPageKey
string
A pagination token returned in the previous response. Pass this value to retrieve the next page of results. Omit this parameter to fetch the first page.

Response

Success Response (200)

items
array
An array of generated video objects, sorted by creation date (newest first). Up to 100 items are returned per page.
nextPageKey
string
A pagination token to retrieve the next page of results. This field is only present when additional pages are available. Pass this value as the nextPageKey query parameter in the next request.

Response Examples


Status Codes


Response Fields


Pagination

The API returns up to 100 videos per page. If more results are available, the response includes a nextPageKey field. To retrieve subsequent pages, pass this token as a query parameter in the next request. Example paginated request:
When no nextPageKey is present in the response, you have reached the last page.

Code Examples

Replace YOUR_API_KEY with your actual API key from the API Access page.