Better-CS-API Docs
Demo Download

Create Demo Download Task

POST
/hltv/demo

Creates a task to generate demo URL for a given HLTV match ID. The endpoint returns a task ID, which can be used to poll the task status and retrieve the result once processing is complete.

Once finished, the result contains the download URL to the demo file hosted in our storage bucket, allowing you to download it.

Credits

  • $0.045 per GB of downloaded demo data.
  • File sizes are rounded up to the next full GB.
    • 0.8 GB → billed as 1 GB
    • 1.2 GB → billed as 2 GB
    • 2.0 GB → billed as 2 GB
  • An initial deposit of 75 credits is reserved when the task is created (covers up to 2 GB).
  • Once the task has finished, we calculate the actual file size and charge only the required number of credits. Any unused credits from the initial deposit are refunded automatically.

In case of errors, your credits are refunded automatically. Credits are not fully refunded for invalid IDs (404) - 1 credit is charged for the search.

Authorization

HTTPBearer
AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X POST "https://example.com/hltv/demo" \  -H "Content-Type: application/json" \  -d '{    "id": "string"  }'
{  "taskId": "string",  "status": "pending"}
Empty
Empty
{  "detail": [    {      "loc": [        "string"      ],      "msg": "string",      "type": "string",      "input": null,      "ctx": {}    }  ]}
Empty