Panda Video

List the account's AI works (subtitles, translations, dubbing, lipsync, eBook=ABSTRACT, mind map=MINDMAP, quiz=QUESTIONS) page by page, newest first, with status (QUEUE, RUNNING, FINISHED, ERROR, SKIPPED). Only the latest attempt of each video × type × language. Filters: status, updated_since, video_id, folder_id (the API doesn't filter by type). Read-only. Returns {works: [{id, video_id, type, status, from_lang, to_lang, credits_charged, created_at, updated_at}], page, pages, total}.

List all A/B test comparisons. Status: DRAFT → IN_PROGRESS → COMPLETED. Returns array of {id, name, description, status, videos: [], winner_video_id, created_at}.

List the domain referrers set directly on a folder. Returns { refers: [{ id, url, type, status, origin: { type, id } }] }. library_id is resolved automatically when omitted.

List the effective referrers that apply to a folder using override-total semantics: the folder's own referrers if it has any, otherwise the library-level referrers. Use this to know which domains actually gate playback for videos in the folder. Returns { refers: [{ id, url, type, status, origin: { type, id } }] }. library_id is resolved automatically when omitted.

List all folders. Returns array of {id, name, parent_folder_id, status, created_at, videos_count}.

List all funnels. Returns {data: [{id, name, videos_count, created_at}]}. A funnel with videos_count=0 has no videos. Funnels are NOT folders.

List the account's videos that are already encrypted (HLS). Videos still in an encryption batch only show up when it finishes (see panda_get_hls_encryption_batches). Returns {total, page, limit, pages, videos: [{id, title, status, folder_id, encrypted_at, available_resolutions, ...}]}. Default 25 videos per page, max 50; keep calling with page+1 while page < pages.

List all invoices. Returns array of {id, status, amount_due, amount_paid, created, due_date, invoice_pdf, hosted_invoice_url}.

List all live streams. Returns array of {id, title, status, scheduled_at, region, quality_package, save_vod, stream_key_id, stream_key, rtmp, live_player, created_at}. Status: provisioning (channel starting), offline (waiting for signal or scheduled), online, finishing, finished, finished_imported (recording became a video), expired (no signal in time; can be regenerated). stream_key is a secret credential: show it only when the user asks for it (e.g. to set up OBS).

List the notices the Panda team sent to the account (tips, alerts, news) — the ones shown in the dashboard notice card and Notifications panel. Only the account owner and admins have notices: any other user gets an empty list (not an error). Status: 'sent' = unread, 'read' = dismissed, 'completed' = the user already acted on it (clicked its button). Returns up to 100 [{id, notice_type, title, text, primary_button, secondary_button, status, created_at, read_at, completed_at}].

List pending removals that can still be undone. type 'partial' = qualities/backup removed with panda_request_partial_deletion (cancel with panda_cancel_partial_deletion); 'video' = whole videos in the trash; 'all' (default) = both. Returns {retention_days, partial_deletions, pagination}.

List available subscription plans and pricing

List all playlists. Returns array of {id, name, videos_quantity, duration, access_type, updated_at}.

List the account's player profiles (GET /profile). 'Profiles' are player UI configs, not user accounts. Returns an array of {id, name, pullzone_name, is_default, updated_at, videos_count, feature_tags, colors, availableQualities}. The default profile ('Padrão') has is_default=true. Exclusive profiles (a single video's own customized player) are NOT listed. Use panda_get_profile for a profile's full settings. No pagination.

List the library-level domain referrers (Domain Protection / allow-block list for playback). Returns { refers: [{ id, url, type, status }] } where type is ALLOW|BLOCK and status is one of active|inactive|pending|deleting|turning_inactive. library_id is resolved automatically when omitted.

List all of the library's domains consolidated by hostname across library and folder scopes. Returns { refers: [{ hostname, type, status, scope, library_refer_id, folders, type_inconsistency, created_at }] }. scope is library|folder|mixed; status may be 'mixed' when rows differ; library_refer_id is the library-level row id (null if folder-only); folders is an array of { folder_id, name, refer_id, status }; type_inconsistency=true when the same hostname has divergent ALLOW/BLOCK rows. Referrers with status=deleting are ignored. library_id is resolved automatically when omitted.

List all generated segments (clips) for a Shorts job. Each segment has viralScore, duration, transcription.

List all Shorts jobs. Projects expire after ~30 days. Returns array of {job_id, status, user_context: {video_title, source_type}, completed_segments, created_at}.

List all stream keys for live broadcasting. Returns array of {id, title, region, default, stream_key, in_use, in_use_by: {live_id, title, status}, created_at}. A key is held (in_use) by a live that is online, provisioning, expired, waiting to start or scheduled within 24h; an expired live holds it until regenerated or deleted. stream_key is a secret credential: show it only when the user asks for it (e.g. to set up OBS).

List all subaccounts and their usage limits. Returns array of {organization_id, name, status, credits_balance, storage_used, limits}.

List all users in the organization. Returns array of {id, name, email, role_id, role_name, created_at}.

List videos. Each video has: id, video_external_id, title, status, created_at, length (seconds), folder_id, config. `id` is what most tools take as video_id; video_external_id is what panda_get_best_times_by_videos / panda_get_viewers_by_videos take. Results are returned newest first by default. There is NO server-side date filter or sorting — to find videos created on a specific date, fetch videos and check created_at in the response.

List all watermark groups. Returns array of {id, name, active, video_ids: [], folder_ids: [], created_at}.

Add or remove videos and/or folders from a DRM watermark group. Returns the updated group with current video_ids and folder_ids.

Move one or more videos to a folder

Re-encode a video with a compression mode (no credit cost). The video is processed again from its original file (backup): without the backup the API refuses. Its current qualities are replaced by the re-encoded ones and it stays in processing until done. Encryption (HLS) is kept. To encrypt videos use panda_encrypt_videos.

Generate AGAIN an existing AI package resource of a video in one language — PAID and cannot be undone: the current one is deleted first, including every edit made to it. Cost: 1 credit per minute of video (minimum 1 min; a partial minute counts only past 1 s); free on an active Gold/Enterprise plan while the daily AI quota lasts (checked before sending). Without new settings it reuses the previous ones. Refused while the resource is still generating, for uploaded PDF eBooks, or when the balance doesn't cover it. Also the way to make a legacy (old package) resource editable. Returns {video_id, resource, lang, gross_cost_credits, cost_credits, free_by_daily_quota, response}; response is the queued request, and while it generates the resource is missing from the video.

Regenerate an expired live so it can be broadcast again. Only works when status is expired (otherwise 400 with the current status). Keeps the same stream key, but the RTMP server may change: update it in OBS. Start broadcasting within 15 minutes or the live expires again. Returns {id, status: provisioning, stream_key, stream_key_id, rtmp, region, started_at}. stream_key is a secret credential: show it only when the user asks for it (e.g. to set up OBS).

Remove ONE video from a Tutor AI assistant: the tutor stops using it and its knowledge is deleted from the tutor. The video stays in the library. Refused when the video isn't bound to the tutor, when it is the tutor's last video (use panda_delete_ai_assistant to delete the tutor), and while the video is still being processed by the tutor (queued/processing — try again when it finishes). Returns {assistant_id, video_id}.

Remove a video from a playlist. Does NOT delete the video.

Remove one or more videos from a funnel. The videos leave the funnel and go to the library root — they are not deleted (the dashboard deletes them in a second call; this tool does not).

Request an async download for a video. Only works for CONVERTED, non-external, non-Hotmart videos. Returns {status, url?}: when status is 'ready' the response already has `url` (a temporary signed link); otherwise poll panda_check_download_status with the same format/quality/language. Lipsync dubbing is a separate video: to download it, pass the video_external_id of that language's entry in config.lipsync_info[] (panda_get_video) and language = that language.

Remove some qualities and/or the original file (backup) of ONE CONVERTED video to free storage, keeping the video. The removed items disappear right away and are deleted for good after retention_days (30); until then panda_cancel_partial_deletion restores them. Videos from an external source are refused. Refused when it would leave the video with no quality: the API would send the whole video to the trash instead — use panda_delete_videos to delete a video. Returns {retention_days, action, remaining_qualities, ignored, partial_deletion}.

Reset a player profile to the account's global player settings (panda_get_player_config): controls, colors, VSL, general, save progress, hideControlsOnStart and availableQualities are all replaced — this also drops the profile's theme, gear menu, caption size and offline settings unless the global has them. Changes every video linked to the profile. Returns the restored profile.

Save a Short segment to the video library as an independent video

Allow or block viewers from downloading a video's eBook, mind map or quiz (the dashboard's "Allow download"). Applies to every language of that resource. Free.

Turn the library's domain protection on or off (block_none_refer). false = protection OFF for the whole library: every request plays, with or without a referer, and even BLOCK domains are ignored. true = the ACTIVE domains apply: requests without a referer are blocked (native TV/iOS players excepted), with ALLOW domains only matching referers play, with only BLOCK domains the matching referers are blocked; with no active domain nothing is blocked. WARNING: this also rewrites the status of ALL the library's domains (library and folders): true activates every domain, including ones turned off on purpose (to keep one off, deactivate it afterwards with panda_set_refer_status); false deactivates all of them. Refused (400) while any domain is still pending, deleting or turning inactive. The server recalculates the flag afterwards: it is true while at least one domain is active. On error the API returns { errCode, errMsg }. library_id is resolved automatically when omitted.

Make a profile the account's default player profile ('Padrão'). Exclusive profiles cannot be default. If the current default profile has videos, ASK the user what happens to them and pass unlinked_videos_strategy: 'apply-new' = they follow the new default; 'keep-current' = they stay with the current profile. Without it only the default flag changes and no video is touched. Video changes run in the background (videoMigrationQueued). Returns {message, id, videoMigrationQueued}.

Turn Exclusive Playback on or off (dashboard: Security > Anti-Download > "Reprodução Exclusiva", Beta). When ON, the on-demand videos of the account are served only to the Panda Player: the Panda Player embedded by iframe keeps working on any site allowed by domain protection (members areas that use the embed included), while custom players, scrapers or extensions that open the HLS (m3u8) link directly get a decoy video. It deters casual capture; it is not DRM. Covers on-demand videos, Libras and the main audio; does not cover live streams, dubbed audio tracks, subtitles or downloads (they keep working). Requires the Simple Anti-Download to be ON (checked before changing; turn it on with panda_action_set_anti_download); turning Simple Anti-Download off turns Exclusive Playback off too. Turning on is only for plans that include Simple Anti-Download (Gold/Enterprise and others; Silver/Bronze need the "Anti-Download Simples" add-on, contracted in the dashboard; not available on Clipador/Clipper and VSL Only plans).

Turn automatic encryption (HLS) of NEW uploads on or off. No credit cost. Turning on is only for Gold/Enterprise plans or accounts with the 'Anti-Download Criptografado' add-on (checked before changing; otherwise refused). Existing videos don't change: to encrypt them use panda_encrypt_videos (paid). Turning off only affects future uploads: videos already encrypted stay encrypted, and a paid add-on stays billed until it is removed in the dashboard.

Activate (active=true) or deactivate (active=false) a single referrer by refer_id. Activation moves inactive→pending; deactivation moves active→turning_inactive (the async worker finalizes the state). If the referrer is already in an intermediate state (pending|deleting|turning_inactive) the API returns 400 ({ errCode, errMsg }: 'Operation in progress, ...'). Works for both library- and folder-level referrers.

Configure offline playback for a video (mobile app feature)

Start an A/B test (begin collecting data). Only from DRAFT status. Returns the updated comparison with status IN_PROGRESS.

Transfer credits to a subaccount

Update AI assistant information (name, status, etc.)

Show or hide the AI chat widget on the video player

Bind videos to an AI assistant (Tutor). Additive: only videos not yet bound are added; videos already bound stay as they are and nothing is unbound (use panda_remove_tutor_video to remove one). Only CONVERTED videos: if any ID doesn't exist or isn't CONVERTED, the whole request is refused. Billing: each NEW video without a subtitle in the tutor's language gets a transcription, charged at ceil(minutes/5) credits per video (Gold/Enterprise plans outside trial get free transcriptions up to a daily limit); without enough credits the API refuses before binding anything.

Edit an existing AI package resource of a video in one language, like the dashboard editor — free. Quiz: send `questions` (the WHOLE new list, 1 to 10 questions, 2 to 5 options each, read it first with panda_get_ai_resource_content) and/or `quiz_settings`. Mind map: `mindmap_edits` (replace an excerpt that exists in one topic only) and/or `mindmap_settings`. eBook: `ebook_edits` (replace an excerpt that exists once in the text), `cover` and/or `ebook_config` (style, logo); the eBook is then recomposed from its text (manual formatting done in the dashboard editor may be lost; images stay) and the new PDF is ready in about 1 minute. Legacy resources (old package) and uploaded PDF eBooks can't be edited. Returns {video_id, resource, lang, saved, changes}; read the result with panda_get_ai_resource_content.

Update auto-recharge settings

Update a CTA on a video. Only the fields you pass are changed; everything else keeps its current value. Placement cannot be changed — delete and re-add the CTA instead.