Media

Media Download Async

POST
/v2/media/async

Download media from a URL asynchronously. Returns a task ID immediately.

Authorization

BearerAuth
AuthorizationBearer <token>

In: header

Request Body

application/json

country?string
expected_mime_types?array<string>
locale?string
storage?
url*string
Formaturi
callback_url?string

URL to call back when async operation completes

storage_compress?boolean

Whether to compress stored data

storage_object_name?string

Custom name for the stored object

storage_type?string

Type of storage to use for results

storage_url?string

URL for storage location

Response Body

application/json

curl -X POST "https://example.com/v2/media/async" \  -H "Content-Type: application/json" \  -d '{    "url": "http://example.com"  }'
{  "status": "success",  "task": {    "_query": null,    "account_name": "string",    "api_type": "web",    "batch_id": "4b0a90bf-c951-42e4-95b3-a95a65ba69fc",    "created_at": "2024-01-15T10:30:00Z",    "download_url": "https://api.webit.live/api/v2/tasks/123e4567-e89b-12d3-a456-426614174000/results",    "error": "Connection timeout",    "error_type": "timeout_error",    "id": "123e4567-e89b-12d3-a456-426614174000",    "input": null,    "modified_at": "2024-01-15T10:35:00Z",    "output_url": "string",    "queue": "string",    "state": "pending",    "status_code": 200,    "status_url": "https://api.webit.live/api/v2/tasks/123e4567-e89b-12d3-a456-426614174000"  }}