# Panda Video Referrer Management API

**Canonical:** https://apis.io/apis/pandavideo-com/pandavideo-com-referrer-management-api/  
**Provider:** Panda Video — https://apis.io/providers/pandavideo-com/  
**Base URL:** https://api-v2.pandavideo.com  
**Documentation:** https://docs.pandavideo.com/reference

Panda Video Referrer Management API is one of 73 APIs that [Panda Video](https://apis.io/providers/pandavideo-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Referrer Management. The published artifact set on APIs.io includes an OpenAPI specification.

<br /> # Referrer Management Manages the **whitelist of domains** allowed to embed and play videos from this library. Combined with `block_none_refer`, this is the primary mechanism to control where the player is allowed to load. > 🚧 **All operations in this section require the `?action=` query parameter.** Without it, POST/DELETE requests return `405 Unsupported method`, and GET falls back to "library details" instead of returning referrers. ## Endpoints and actions | Method | `?action=` | Operation | |---|---|---| | GET | `refer` | List allowed referrers | | POST | `refer` | Add 1+ referrers | | POST | `referValidation` | Toggle the `block_none_refer` policy | | DELETE | `refer` | Remove 1+ referrers (asynchronous) | ## Referrer lifecycle ``` pending → active (worker confirmed the domain at the CDN) active → turning_inactive (when block_none_refer is set to false) active → deleting → row destroyed (worker removed from CDN) inactive ↔ pending (re-activated when block_none_refer turns true) ``` Intermediate states (`pending`, `turning_inactive`, `deleting`) typically resolve in seconds to a couple of minutes. Operations against a referrer in an intermediate state are rejected with `400 You have domains loading, please wait until they are loaded`. ## Side effects - Every mutation pushes a message to SQS — the refer worker reconciles the whitelist with Bunny CDN's `videolibrary` allowed-referers list. - Required system domains are always injected by the worker (dashboard, gstatic, `player-*` hostnames) — you do **not** need to add them manually. - Audit log entries are queued for `add` and `remove` actions under the `security` category. ## Business rules - `hostname` is validated by a strict regex (no scheme, no commas; wildcard `*.example.com` accepted). - Duplicate hostnames per library return `400 Refer already exists` (case-insensitive match). - Only `type: ALLOW` is processed today; the field is required but its value is effectively fixed.

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| GET | `/library/{library_id}` | Get library details or referrers |
| POST | `/library/{library_id}` | Add library or folder referrers |
| DELETE | `/library/{library_id}` | Delete library or folder referrers |
| PATCH | `/library/{library_id}` | Toggle a single referrer status (activate / deactivate) |
| PUT | `/library/{library_id}/refer` | Update allowed domains (bulk) |

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/pandavideo-com/openapi/pandavideo-com-referrer-management-api-openapi.yml

## Other Panda Video APIs (12)

- [analytics-api](https://apis.io/apis/pandavideo-com/analytics-api/)
- [Panda Video AI Generation API](https://apis.io/apis/pandavideo-com/pandavideo-com-ai-generation-api/)
- [Panda Video AI Images API](https://apis.io/apis/pandavideo-com/pandavideo-com-ai-images-api/)
- [Panda Video AI Package API](https://apis.io/apis/pandavideo-com/pandavideo-com-ai-package-api/)
- [Panda Video AI Resource Files API](https://apis.io/apis/pandavideo-com/pandavideo-com-ai-resource-files-api/)
- [Panda Video Analytics API](https://apis.io/apis/pandavideo-com/pandavideo-com-analytics-api-api/)
- [Panda Video App API](https://apis.io/apis/pandavideo-com/pandavideo-com-app-api/)
- [Panda Video Assist Ai API](https://apis.io/apis/pandavideo-com/pandavideo-com-assist-ai-api/)
- [Panda Video Assistants API](https://apis.io/apis/pandavideo-com/pandavideo-com-assistants-api/)
- [Panda Video Audios API](https://apis.io/apis/pandavideo-com/pandavideo-com-audios-api/)
- [Panda Video Audit Logs API](https://apis.io/apis/pandavideo-com/pandavideo-com-audit-logs-api/)
- [Panda Video Block Download API](https://apis.io/apis/pandavideo-com/pandavideo-com-block-download-api/)

## Tags

Referrer Management

## Use this from code or an agent

- **REST, no key:** `GET https://apis.io/api/v1/providers/pandavideo-com` returns the provider's full profile as JSON.
- **MCP:** `https://apis.io/mcp` (Streamable HTTP) — search the catalog, read any provider, compare providers, check agent readiness.
- **Free API key** for catalog-wide search, ratings and comparisons: sign in with GitHub, Google or LinkedIn at https://apis.io/developer/account/ (plans: https://apis.io/developer/plans/).

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/pandavideo-com/pandavideo-com-referrer-management-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/pandavideo-com/.
