# Introduction

The AtomicPlayer API is a JSON API at `https://api.atomicplayer.ai`. It covers the same product you use in the dashboard: videos, folders, tags, player configuration, analytics, and webhooks.

```bash
curl "https://api.atomicplayer.ai/v1/videos?workspaceId=$WORKSPACE_ID" \
  -H "Authorization: Bearer $ATOMICPLAYER_API_KEY"
```

A successful response always has the same shape.

```json
{
  "success": true,
  "data": { "videos": [] },
  "error": null
}
```

## What you can do

- Create a video, upload the file, and wait until `status` is `ready`.
- Organize videos with folders and tags.
- Create a player, save a draft, and publish the version the embed serves.
- Read playback, retention, audience, and revenue for a workspace.
- Receive signed webhooks when someone watches, finishes, converts, or when a video becomes ready.

Paths, field names, and scope names stay in English on every language of this site.

## Where to go next

1. [Authentication](/authentication) explains API keys, scopes, and the one set of routes that needs a dashboard session.
2. [Requests](/requests) covers the response envelope, errors, and the monthly allowance.
3. [Webhooks](/webhooks) covers the event catalog and how to verify a delivery.
4. The [API reference](/api) lists every route, with request and response examples.

The OpenAPI document is also available as a file: [openapi.json](/openapi.json). Spanish and Portuguese copies are [openapi.es.json](/openapi.es.json) and [openapi.pt.json](/openapi.pt.json).
