Where is the highest-quality Douyin video URL, and why does it expire?
The highest-quality Douyin video URL is data.original_video_url in the response of douyin.app.v3.fetch_video_high_quality_play_url. Request one identified video, then save a matched playback record rather than pasting a bare URL into a spreadsheet. Because data.original_video_url is signed and can expire, request a fresh URL when you need playback access later. playback_record.py runs a local identity check that writes a private playback JSON and a URL-free review summary without downloading or publishing the video.
Which input avoids buying the same lookup twice?
region is the ISO country code of the request exit, such as CN, US or HK. region is not a content-language or creator-location filter. For viewing in mainland China, set CN explicitly; without region, the service’s own exit is used. No region value guarantees that every returned CDN URL plays in every location.
Looking up ten videos once takes ten requests, and each URL refresh adds a request. See BeatAPI pricing.
How do I request and preserve one result?
Save the JSON below as request.json, and replace the placeholder with your actual ID. Use only one input form: when starting from a share URL, replace the aweme_id entry with share_url. Keep the API key in a local environment variable, never in the JSON or a shared document.
The new folder keeps an earlier observation from being overwritten. A failed HTTP request or a failed response envelope is a failed lookup, not a usable media result. Keep the failed lookup’s request ID for diagnosis; do not loop over regions or keep buying replacement lookups.
How do I check the identity and hand off the result?
Save the script below as playback_record.py and run python3 playback_record.py playback-call/response.json YOUR_REAL_VIDEO_ID playback-review. For a share-URL lookup, first compare the returned video_id with the post the share link actually opens. Passing an ID copied from the response only proves the response is internally consistent; only the comparison with the opened post shows you selected the right post.
playback-private.json keeps the exact signed URL and the source hash, and raw-response.json keeps the original response bytes; treat both playback-private.json and raw-response.json as private working files. review-summary.json omits the URL but keeps video_id, request_id, media_host, metadata, and source_sha256, so verify those fields before sharing review-summary.json. playback_record.py makes no HTTP request, does not print the signed URL, rejects a mismatched video_id, and refuses to overwrite an existing folder.
The returned metadata describes one specific response: content_type is the returned MIME label, file_size keeps the original string, and file_size_in_mb stays numeric when present. Missing optional metadata stays null, not zero. Neither size value is checked against downloaded bytes. Read data.original_video_url, not the nested play_addr path of a detail endpoint, and do not read multiple mirror addresses as different quality levels.
What if the URL fails tomorrow?
The playback URL is signed, and expires_at: null means the response provided no expiration time. If data.original_video_url returns 403 or 404 the next day, first check whether the original post still opens. If you still need a playback URL, request a new URL for the same aweme_id and save the new URL and retrieval time as a separate record. Each refresh counts as another request.
The record sets url_checked: false and downloaded: false on purpose: the local check does not prove reachability, image quality, codec compatibility, or a completed backup. Do not publish signed URLs as stable website assets. A playback URL does not grant copyright, republication permission, subtitles, or a transcript. The workflow on this page ends with a verified metadata handoff, not a media archive.
Post metrics and source checks · Video IDs and share links
Contract basis: data:douyin.app.v3.fetch_video_high_quality_play_url. playback_record.py validates saved responses locally without network calls.
How should I hand off video references from different platforms?
First decide whether the team needs the original work, the duration or the spoken content. For Douyin, verify the work and URL with the steps on this page. For Xiaohongshu, see video text and media and keep the description and URL actually returned. For WeChat Channels, follow channel and work identifiers to confirm the detail and media source. For every platform, record the platform, work ID, retrieval time, available material, playback verification and caption availability. In the review sheet, share original work links and traceable request IDs; keep originals that carry access credentials in the internal record.

