API referencePlayback
Public metadata for a shared video
Public metadata for a shared video
GET
/v1/playback/public-videos/{videoId}Unauthenticated metadata for a video whose visibility is public or
unlisted — backs the hosted watch page and oEmbed unfurls. Videos
that are private, deleted, or unknown all return the same 404, so
the endpoint reveals nothing about unshared content. Rate limit:
120 requests per 60 s per IP.
Error codes: video_not_found (404).
Authentication
- This operation needs no authentication.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
videoId | path | string (Ulid) | Yes | — |
Request body
This operation takes no request body.
Responses
| Status | Meaning |
|---|---|
200 | Public video metadata. |
404 | The resource does not exist or is not visible to this caller. |
429 | Rate limit exceeded. |
Try it
GET
/v1/playback/public-videos/{videoId}Test mode only
API playground
Send a live request to api.videohati.com with a test-mode key.
This playground blocks vh_live_ keys. Use a key that starts with vh_test_ only; a request with a live key never leaves your browser.
The key is stored in your browser on docs.videohati.com only.