Skip to main content
GET
/
download
List download entries
curl --request GET \
  --url https://api.videodb.io/download \
  --header 'x-access-token: <api-key>'
{
  "success": true,
  "data": {
    "downloads": [
      {
        "id": "download-12345",
        "name": "video_download.mp4",
        "status": "done",
        "created_at": "2023-11-07T05:31:56Z",
        "download_url": "https://example.com/download/video.mp4"
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.videodb.io/llms.txt

Use this file to discover all available pages before exploring further.

Retrieve paginated list of all download jobs in your account. Each entry shows download status, timestamps, and download URLs for completed jobs. 
import requests

response = requests.get(
    "https://api.videodb.io/download",
    headers={"x-access-token": "your_api_key"},
    params={
        "page_index": 0,
        "count": 50
    }
)

result = response.json()
downloads = result.get('data', {}).get('downloads', [])
for download in downloads:
    print(f"{download['id']}: {download['name']} - {download['status']}")
  • Results are paginated with page_index and count parameters
  • count has a maximum of 5,000 items per request
  • Status can be processing, done, or error
  • Completed downloads include a download_url valid for 24 hours

Get Download Status

Get detailed information for a specific download

Create Download

Start a new download job

Authorizations

​
x-access-token
string
header
required

API key for authentication (sk-xxx format)

Query Parameters

​
page_index
integer
Example:

0

​
count
integer
Required range: x <= 5000
Example:

50

Response

200 - application/json

List of downloads

​
success
boolean
Example:

true

​
data
object