List User Videos

GEThttps://api.konpro.ai/v1/videos

Fetch a paginated list of videos associated with the authenticated user account. You can filter by folder, title, and control the number of videos returned per request.

Request History

TIME	STATUS	USER AGENT
Make a request to see history.

0 Requests This Month

Query Parameters

Parameter	Type	Description
limit	integer	Number of videos to retrieve in one call (0-100). Optional.
folder_id	string	Filter videos by folder ID. Defaults to root if empty or omitted.
title	string	Filter videos by title keyword (optional).
token	string	Pagination token for fetching subsequent pages (optional).

Response Fields

Field	Type	Description
code	integer	Status code indicating the result of the request (e.g., 100 = success)
data	object	Contains video list data
data.token	string	Pagination token to fetch the next set of results; null if no more data
data.total	integer	Total number of videos associated with the user
data.videos	array	Array of video objects
message	string	Additional message or error details; null if none

Each video object contains:

Field	Type	Description
video_id	string	Unique identifier of the video
status	string	Current video status (e.g., "completed", "processing", "failed", "draft")
created_at	number	Unix timestamp representing video creation time
type	string	Video type: "GENERATED" or "TRANSLATED"
folder_id	string	ID of the folder containing the video (empty for root folder)

Example Request (Shell)

shell

curl --request GET \
--url 'https://api.konpro.ai/v1/videos?limit=50' \
--header 'accept: application/json' \
--header 'x-api-key: <your-api-key>'

Create Avatar IV Video Retrieve Sharable Video URL

LANGUAGE

CREDENTIALS

Header

HEADER

RESPONSE

Examples

Click to start a request and see the response here! Or choose an example:

application/json

200 - Result

400 - Result