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"
      }
    ]
  }
}
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