Preview Multiple URL to Videos (Async)

FreshPOST

POST https://api.creatify.ai/api/link_to_videos/preview_list_async/

Generate previews for multiple URL-to-video tasks asynchronously. This is more efficient than calling the preview endpoint individually for each task.

Request Body

Name	Type	Required	Description
ids	array	Yes	Array of task IDs to preview

Headers

Header	Type	Required	Description
X-API-ID	string	Yes	Your Creatify API ID
X-API-KEY	string	Yes	Your Creatify API key
Content-Type	string	Yes	application/json

Example Request

curl -X POST 'https://api.creatify.ai/api/link_to_videos/preview_list_async/' \
  -H 'X-API-ID: your-api-id' \
  -H 'X-API-KEY: your-api-key' \
  -H 'Content-Type: application/json' \
  -d '{
    "ids": ["ltv-001", "ltv-002", "ltv-003"]
  }'

Response

{
  "tasks": [
    {
      "id": "ltv-001",
      "status": "processing"
    },
    {
      "id": "ltv-002",
      "status": "processing"
    },
    {
      "id": "ltv-003",
      "status": "processing"
    }
  ]
}

Status Codes

Code	Description
200	Preview generation started for all tasks
400	Bad request -- invalid task IDs
401	Unauthorized -- invalid API credentials
402	Insufficient credits
429	Rate limit exceeded
500	Internal server error

TIP

Use GET /api/link_to_videos/{id}/ to poll individual task status. Each task processes independently, so some may complete before others.

WARNING

Credits are deducted for each preview in the batch. Ensure you have sufficient credits for all previews before making the request.