Summary
Downloadable content on FACEIT’s Cloud infrastructure is private by default and can only be accessed with a signed URL. The Downloads API takes a Cloud file resource URL as a parameter and returns a signed URL for the file. Resource URLs to these downloadable content are included in the Data API responses when available, such as the game demo file URLs that can be found in the Matches endpoint responses. Subscribe to the "Match Demo Ready" webhook to get updates when a demo is uploaded in the cloud storage. Find more details here https://docs.faceit.com/getting-started/Guides/event-notifications
Getting Access
To get access to the Downloads API, you need to fill out the application form linked below consisting of 3 sections with questions that will help us understand your intended use of the API. The expected response time for the application is 30 days.
Apply at https://fce.gg/downloads-api-application . The expected response time for applications is 30 days. If you have any questions, concerns, or if your application has an urgency, please feel free to reach out to us at [email protected].
Endpoints
Demos
| Method | URL | Description |
|---|---|---|
| POST | /download/v2/demos/download | Returns a signed download URL. |
Request Parameters
| Name | Description | Type |
|---|---|---|
| resource_url | The Cloud resource URL of the file | string |
Request Body Format
{
"resource_url":"https://demos.faceit.com/csgo/1-cb038819-b0d0-4471-b25c-0e7468ab1eb1-1-1.dem.gz"
}
Response Body Format
{
"payload":{
"download_url": "<signed_url>"
}
}
Authentication
Downloads API requires authentication with an exclusive Access Token that has a Downloads API scope. In order to authenticate, a valid Access Token in the Authorization header needs to be sent using the Bearer authentication scheme.