{"openapi":"3.1.0","info":{"title":"EasyDown API","version":"1.0.0","description":"Parse public media URLs into normalized media or platform-specific full data."},"servers":[{"url":"https://api.easydown.org"}],"security":[{"bearerAuth":[]}],"paths":{"/api/v1/parse":{"post":{"operationId":"parseMedia","summary":"Parse media into the normalized EasyDown format","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParseRequest"}}}},"responses":{"200":{"description":"A successful parse. One credit is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NormalizedResponse"}}}},"4XX":{"description":"Authentication, permission, URL, or balance error. No credit is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Temporary service error. No credit is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/platforms/{platform}/parse":{"post":{"operationId":"parsePlatformMedia","summary":"Parse media with normalized media and full platform data","parameters":[{"name":"platform","in":"path","required":true,"schema":{"type":"string","enum":["tiktok","douyin","toutiao","youtube","twitter","instagram","threads","xiaohongshu","bilibili","kuaishou","weibo"]}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParseRequest"}}}},"responses":{"200":{"description":"A successful parse. One credit is charged.","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/TiktokPlatformResponse"},{"$ref":"#/components/schemas/DouyinPlatformResponse"},{"$ref":"#/components/schemas/ToutiaoPlatformResponse"},{"$ref":"#/components/schemas/YoutubePlatformResponse"},{"$ref":"#/components/schemas/TwitterPlatformResponse"},{"$ref":"#/components/schemas/InstagramPlatformResponse"},{"$ref":"#/components/schemas/ThreadsPlatformResponse"},{"$ref":"#/components/schemas/XiaohongshuPlatformResponse"},{"$ref":"#/components/schemas/BilibiliPlatformResponse"},{"$ref":"#/components/schemas/KuaishouPlatformResponse"},{"$ref":"#/components/schemas/WeiboPlatformResponse"}]}}}},"4XX":{"description":"Authentication, permission, URL, platform, or balance error. No credit is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Temporary platform service error. No credit is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/platforms/tiktok/parse":{"post":{"operationId":"parseTiktokMedia","summary":"Parse TikTok media with normalized media and full platform data","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParseRequest"}}}},"responses":{"200":{"description":"A successful parse. One credit is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TiktokPlatformResponse"}}}},"4XX":{"description":"Authentication, permission, URL, platform, or balance error. No credit is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Temporary platform service error. No credit is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/platforms/douyin/parse":{"post":{"operationId":"parseDouyinMedia","summary":"Parse Douyin media with normalized media and full platform data","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParseRequest"}}}},"responses":{"200":{"description":"A successful parse. One credit is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DouyinPlatformResponse"}}}},"4XX":{"description":"Authentication, permission, URL, platform, or balance error. No credit is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Temporary platform service error. No credit is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/platforms/toutiao/parse":{"post":{"operationId":"parseToutiaoMedia","summary":"Parse Toutiao media with normalized media and full platform data","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParseRequest"}}}},"responses":{"200":{"description":"A successful parse. One credit is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToutiaoPlatformResponse"}}}},"4XX":{"description":"Authentication, permission, URL, platform, or balance error. No credit is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Temporary platform service error. No credit is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/platforms/youtube/parse":{"post":{"operationId":"parseYoutubeMedia","summary":"Parse YouTube media with normalized media and full platform data","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParseRequest"}}}},"responses":{"200":{"description":"A successful parse. One credit is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/YoutubePlatformResponse"}}}},"4XX":{"description":"Authentication, permission, URL, platform, or balance error. No credit is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Temporary platform service error. No credit is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/platforms/twitter/parse":{"post":{"operationId":"parseTwitterMedia","summary":"Parse Twitter / X media with normalized media and full platform data","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParseRequest"}}}},"responses":{"200":{"description":"A successful parse. One credit is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TwitterPlatformResponse"}}}},"4XX":{"description":"Authentication, permission, URL, platform, or balance error. No credit is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Temporary platform service error. No credit is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/platforms/instagram/parse":{"post":{"operationId":"parseInstagramMedia","summary":"Parse Instagram media with normalized media and full platform data","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParseRequest"}}}},"responses":{"200":{"description":"A successful parse. One credit is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InstagramPlatformResponse"}}}},"4XX":{"description":"Authentication, permission, URL, platform, or balance error. No credit is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Temporary platform service error. No credit is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/platforms/threads/parse":{"post":{"operationId":"parseThreadsMedia","summary":"Parse Threads media with normalized media and full platform data","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParseRequest"}}}},"responses":{"200":{"description":"A successful parse. One credit is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreadsPlatformResponse"}}}},"4XX":{"description":"Authentication, permission, URL, platform, or balance error. No credit is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Temporary platform service error. No credit is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/platforms/xiaohongshu/parse":{"post":{"operationId":"parseXiaohongshuMedia","summary":"Parse Xiaohongshu / RedNote media with normalized media and full platform data","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParseRequest"}}}},"responses":{"200":{"description":"A successful parse. One credit is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/XiaohongshuPlatformResponse"}}}},"4XX":{"description":"Authentication, permission, URL, platform, or balance error. No credit is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Temporary platform service error. No credit is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/platforms/bilibili/parse":{"post":{"operationId":"parseBilibiliMedia","summary":"Parse Bilibili media with normalized media and full platform data","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParseRequest"}}}},"responses":{"200":{"description":"A successful parse. One credit is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BilibiliPlatformResponse"}}}},"4XX":{"description":"Authentication, permission, URL, platform, or balance error. No credit is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Temporary platform service error. No credit is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/platforms/kuaishou/parse":{"post":{"operationId":"parseKuaishouMedia","summary":"Parse Kuaishou / Kwai media with normalized media and full platform data","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParseRequest"}}}},"responses":{"200":{"description":"A successful parse. One credit is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KuaishouPlatformResponse"}}}},"4XX":{"description":"Authentication, permission, URL, platform, or balance error. No credit is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Temporary platform service error. No credit is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/platforms/weibo/parse":{"post":{"operationId":"parseWeiboMedia","summary":"Parse Weibo media with normalized media and full platform data","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParseRequest"}}}},"responses":{"200":{"description":"A successful parse. One credit is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WeiboPlatformResponse"}}}},"4XX":{"description":"Authentication, permission, URL, platform, or balance error. No credit is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Temporary platform service error. No credit is charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"EasyDown API token"}},"schemas":{"ParseRequest":{"type":"object","properties":{"url":{"description":"Public media URL to parse","type":"string","format":"uri"},"link":{"description":"Compatibility alias for url","type":"string","minLength":1}},"additionalProperties":false},"Media":{"type":"object","properties":{"platform":{"type":"string","enum":["tiktok","douyin","toutiao","youtube","twitter","instagram","threads","xiaohongshu","bilibili","kuaishou","weibo"]},"title":{"type":"string"},"thumbnail":{"type":"string"},"duration":{"type":"number"},"images":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"width":{"type":"number"},"height":{"type":"number"}},"required":["url","width","height"],"additionalProperties":false}},"videos":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"quality":{"type":"string"},"mimeType":{"type":"string"},"width":{"type":"number"},"height":{"type":"number"},"hasAudio":{"type":"boolean"},"source":{"type":"string","enum":["direct","adaptive","dash","live_photo"]},"headers":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}}},"required":["url","quality","mimeType","width","height","hasAudio","source"],"additionalProperties":false}},"audios":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"quality":{"type":"string"},"mimeType":{"type":"string"},"bitrate":{"type":"number"},"source":{"type":"string","enum":["direct","adaptive","dash","native_voice"]},"headers":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}}},"required":["url","quality","mimeType","bitrate","source"],"additionalProperties":false}}},"required":["platform","title","thumbnail","duration","images","videos","audios"],"additionalProperties":false},"NormalizedResponse":{"type":"object","properties":{"status":{"type":"number","const":200},"data":{"type":"object","properties":{"platform":{"type":"string","enum":["tiktok","douyin","toutiao","youtube","twitter","instagram","threads","xiaohongshu","bilibili","kuaishou","weibo"]},"title":{"type":"string"},"thumbnail":{"type":"string"},"duration":{"type":"number"},"images":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"width":{"type":"number"},"height":{"type":"number"}},"required":["url","width","height"],"additionalProperties":false}},"videos":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"quality":{"type":"string"},"mimeType":{"type":"string"},"width":{"type":"number"},"height":{"type":"number"},"hasAudio":{"type":"boolean"},"source":{"type":"string","enum":["direct","adaptive","dash","live_photo"]},"headers":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}}},"required":["url","quality","mimeType","width","height","hasAudio","source"],"additionalProperties":false}},"audios":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"quality":{"type":"string"},"mimeType":{"type":"string"},"bitrate":{"type":"number"},"source":{"type":"string","enum":["direct","adaptive","dash","native_voice"]},"headers":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}}},"required":["url","quality","mimeType","bitrate","source"],"additionalProperties":false}}},"required":["platform","title","thumbnail","duration","images","videos","audios"],"additionalProperties":false},"msg":{"type":"string","const":"success"}},"required":["status","data","msg"],"additionalProperties":false},"ErrorResponse":{"type":"object","properties":{"status":{"type":"number"},"data":{"type":"null"},"msg":{"type":"string"},"code":{"type":"string","enum":["platform_mismatch","unsupported_url","content_unavailable","no_media","upstream_unavailable","platform_not_allowed","insufficient_credits"]}},"required":["status","data","msg"],"additionalProperties":false},"TiktokPlatformData":{"type":"object","description":"The final TikTok post object selected for the requested video or photo post. Documented fields are stable for platformDataVersion 1; additional sanitized public fields can also be present.","additionalProperties":true,"properties":{"aweme_id":{"description":"TikTok post identifier.","type":"string"},"desc":{"description":"Public post caption.","type":"string"},"author":{"description":"Public creator profile fields.","type":"object","additionalProperties":true},"video":{"description":"Video metadata and playable renditions when the post is a video.","type":"object","additionalProperties":true},"images":{"description":"Photo-post image objects when the post contains images.","type":"array","items":{}},"statistics":{"description":"Public engagement counters exposed for the post.","type":"object","additionalProperties":true}},"example":{"aweme_id":"7647557116596718861","desc":"Example public TikTok post","author":{"unique_id":"creator","nickname":"Example creator"},"video":{"width":1080,"height":1920,"duration":12,"play_addr":{"url_list":["https://media.example/video.mp4"]}},"statistics":{"play_count":1200,"digg_count":84}}},"TiktokPlatformResponse":{"type":"object","required":["status","data","msg"],"properties":{"status":{"type":"number","const":200},"data":{"type":"object","required":["media","platformData","platformDataVersion"],"properties":{"media":{"$ref":"#/components/schemas/Media"},"platformData":{"$ref":"#/components/schemas/TiktokPlatformData"},"platformDataVersion":{"type":"string","const":"1","description":"Version of the published platformData contract."}}},"msg":{"type":"string","const":"success"}}},"DouyinPlatformData":{"type":"object","description":"The final Douyin aweme object, or a compact direct-media object for an accepted CDN URL. Documented fields are stable for platformDataVersion 1; additional sanitized public fields can also be present.","additionalProperties":true,"properties":{"aweme_id":{"description":"Douyin work identifier.","type":"string"},"desc":{"description":"Public work caption.","type":"string"},"author":{"description":"Public creator profile fields.","type":"object","additionalProperties":true},"video":{"description":"Video metadata and playable renditions.","type":"object","additionalProperties":true},"images":{"description":"Image-note items when the work is a gallery.","type":"array","items":{}},"music":{"description":"Public soundtrack metadata and playable audio fields.","type":"object","additionalProperties":true},"statistics":{"description":"Public engagement counters exposed for the work.","type":"object","additionalProperties":true},"media_url":{"description":"Accepted direct media URL when direct-media parsing is used.","type":"string"},"media_type":{"description":"Direct-media response kind when direct-media parsing is used.","type":"string"}},"example":{"aweme_id":"7641191614632071546","desc":"Example public Douyin work","author":{"uid":"creator-id","nickname":"Example creator"},"video":{"width":1080,"height":1920,"duration":15000,"play_addr":{"url_list":["https://media.example/video.mp4"]}},"music":{"title":"Original audio"}}},"DouyinPlatformResponse":{"type":"object","required":["status","data","msg"],"properties":{"status":{"type":"number","const":200},"data":{"type":"object","required":["media","platformData","platformDataVersion"],"properties":{"media":{"$ref":"#/components/schemas/Media"},"platformData":{"$ref":"#/components/schemas/DouyinPlatformData"},"platformDataVersion":{"type":"string","const":"1","description":"Version of the published platformData contract."}}},"msg":{"type":"string","const":"success"}}},"ToutiaoPlatformData":{"type":"object","description":"The final Toutiao single-video work object selected from the app response. Documented fields are stable for platformDataVersion 1; additional sanitized public fields can also be present.","additionalProperties":true,"properties":{"group_id":{"description":"Toutiao content group identifier when present.","type":"string"},"item_id":{"description":"Toutiao item identifier when present.","type":"string"},"title":{"description":"Public video title.","type":"string"},"abstract":{"description":"Public content summary.","type":"string"},"poster_url":{"description":"Poster image URL.","type":"string"},"video_duration":{"description":"Video duration reported by Toutiao.","type":"number"},"video_play_info":{"description":"Play information object; older responses can expose the same data as a JSON string.","type":"object","additionalProperties":true}},"example":{"group_id":"7613611314560369152","item_id":"7613611314560369152","title":"Example public Toutiao video","poster_url":"https://media.example/poster.jpg","video_duration":18,"video_play_info":{"video_list":{"video_1":{"main_url":"https://media.example/video.mp4"}}}}},"ToutiaoPlatformResponse":{"type":"object","required":["status","data","msg"],"properties":{"status":{"type":"number","const":200},"data":{"type":"object","required":["media","platformData","platformDataVersion"],"properties":{"media":{"$ref":"#/components/schemas/Media"},"platformData":{"$ref":"#/components/schemas/ToutiaoPlatformData"},"platformDataVersion":{"type":"string","const":"1","description":"Version of the published platformData contract."}}},"msg":{"type":"string","const":"success"}}},"YoutubePlatformData":{"type":"object","description":"The final YouTube player object for the requested video, Short, or replay. Documented fields are stable for platformDataVersion 1; additional sanitized public fields can also be present.","additionalProperties":true,"properties":{"videoDetails":{"description":"Title, duration, channel, thumbnails, and public video metadata.","type":"object","additionalProperties":true},"streamingData":{"description":"Progressive and adaptive audio/video renditions.","type":"object","additionalProperties":true},"playabilityStatus":{"description":"Public playback availability state.","type":"object","additionalProperties":true},"microformat":{"description":"Public page and embed metadata when available.","type":"object","additionalProperties":true},"captions":{"description":"Caption track metadata when exposed.","type":"object","additionalProperties":true}},"example":{"videoDetails":{"videoId":"BiBY6TeIvJ4","title":"Example public YouTube video","lengthSeconds":"42","channelId":"channel-id"},"streamingData":{"formats":[{"itag":18,"mimeType":"video/mp4","qualityLabel":"360p","url":"https://media.example/video.mp4"}],"adaptiveFormats":[{"itag":140,"mimeType":"audio/mp4","bitrate":128000,"url":"https://media.example/audio.m4a"}]},"playabilityStatus":{"status":"OK"}}},"YoutubePlatformResponse":{"type":"object","required":["status","data","msg"],"properties":{"status":{"type":"number","const":200},"data":{"type":"object","required":["media","platformData","platformDataVersion"],"properties":{"media":{"$ref":"#/components/schemas/Media"},"platformData":{"$ref":"#/components/schemas/YoutubePlatformData"},"platformDataVersion":{"type":"string","const":"1","description":"Version of the published platformData contract."}}},"msg":{"type":"string","const":"success"}}},"TwitterPlatformData":{"type":"object","description":"The final public Twitter/X status object and its media variants. Documented fields are stable for platformDataVersion 1; additional sanitized public fields can also be present.","additionalProperties":true,"properties":{"id_str":{"description":"Tweet or post identifier.","type":"string"},"text":{"description":"Public post text when exposed.","type":"string"},"full_text":{"description":"Expanded public post text when exposed.","type":"string"},"user":{"description":"Public author profile fields.","type":"object","additionalProperties":true},"media":{"description":"Video variants and image objects attached to the post.","type":"object","additionalProperties":true},"metrics":{"description":"Public engagement counters when exposed.","type":"object","additionalProperties":true}},"example":{"id_str":"2064933214720803143","full_text":"Example public X post","user":{"screen_name":"creator","name":"Example creator"},"media":{"video":[{"variants":[{"content_type":"video/mp4","bitrate":832000,"url":"https://media.example/video.mp4"}]}]}}},"TwitterPlatformResponse":{"type":"object","required":["status","data","msg"],"properties":{"status":{"type":"number","const":200},"data":{"type":"object","required":["media","platformData","platformDataVersion"],"properties":{"media":{"$ref":"#/components/schemas/Media"},"platformData":{"$ref":"#/components/schemas/TwitterPlatformData"},"platformDataVersion":{"type":"string","const":"1","description":"Version of the published platformData contract."}}},"msg":{"type":"string","const":"success"}}},"InstagramPlatformData":{"type":"object","description":"The final Instagram post, Reel, carousel, or requested active Story item. Documented fields are stable for platformDataVersion 1; additional sanitized public fields can also be present.","additionalProperties":true,"properties":{"id":{"description":"Instagram media identifier.","type":"string"},"code":{"description":"Public post or Reel shortcode.","type":"string"},"caption":{"description":"Public caption fields when available.","type":"object","additionalProperties":true},"user":{"description":"Public author profile fields.","type":"object","additionalProperties":true},"video_versions":{"description":"Playable video renditions for a video item.","type":"array","items":{}},"image_versions":{"description":"Image candidates for a photo or cover.","type":"object","additionalProperties":true},"carousel_media":{"description":"All media items in a public carousel.","type":"array","items":{}},"taken_at":{"description":"Publication timestamp when exposed.","type":"number"}},"example":{"id":"example-media-id","code":"DY2PcmxiBE2","caption":{"text":"Example public Instagram post"},"user":{"username":"creator","full_name":"Example creator"},"video_versions":[{"width":1080,"height":1920,"url":"https://media.example/video.mp4"}],"image_versions":{"candidates":[{"width":1080,"height":1920,"url":"https://media.example/cover.jpg"}]}}},"InstagramPlatformResponse":{"type":"object","required":["status","data","msg"],"properties":{"status":{"type":"number","const":200},"data":{"type":"object","required":["media","platformData","platformDataVersion"],"properties":{"media":{"$ref":"#/components/schemas/Media"},"platformData":{"$ref":"#/components/schemas/InstagramPlatformData"},"platformDataVersion":{"type":"string","const":"1","description":"Version of the published platformData contract."}}},"msg":{"type":"string","const":"success"}}},"ThreadsPlatformData":{"type":"object","description":"Only the Threads post object matching the requested URL, excluding related or recommended posts. Documented fields are stable for platformDataVersion 1; additional sanitized public fields can also be present.","additionalProperties":true,"properties":{"id":{"description":"Threads post identifier.","type":"string"},"code":{"description":"Public post shortcode.","type":"string"},"text":{"description":"Public post text when exposed.","type":"string"},"user":{"description":"Public author profile fields.","type":"object","additionalProperties":true},"images":{"description":"Image items attached to the target post.","type":"array","items":{}},"video_versions":{"description":"Playable video renditions attached to the target post.","type":"array","items":{}},"carousel_media":{"description":"All media items in a carousel post.","type":"array","items":{}}},"example":{"id":"example-thread-id","code":"DDhV3LWhrlk","text":"Example public Threads post","user":{"username":"creator"},"images":[{"url":"https://media.example/image.jpg","width":1080,"height":1350}]}},"ThreadsPlatformResponse":{"type":"object","required":["status","data","msg"],"properties":{"status":{"type":"number","const":200},"data":{"type":"object","required":["media","platformData","platformDataVersion"],"properties":{"media":{"$ref":"#/components/schemas/Media"},"platformData":{"$ref":"#/components/schemas/ThreadsPlatformData"},"platformDataVersion":{"type":"string","const":"1","description":"Version of the published platformData contract."}}},"msg":{"type":"string","const":"success"}}},"XiaohongshuPlatformData":{"type":"object","description":"The final Xiaohongshu/RedNote note object selected for the requested note identifier. Documented fields are stable for platformDataVersion 1; additional sanitized public fields can also be present.","additionalProperties":true,"properties":{"note_id":{"description":"Xiaohongshu note identifier.","type":"string"},"title":{"description":"Public note title.","type":"string"},"desc":{"description":"Public note description.","type":"string"},"type":{"description":"Note media type.","type":"string"},"user":{"description":"Public author profile fields.","type":"object","additionalProperties":true},"images_list":{"description":"All image and live-photo items in the note.","type":"array","items":{}},"video_info_v2":{"description":"Video stream, codec, cover, and dimension metadata.","type":"object","additionalProperties":true},"interact_info":{"description":"Public engagement counters.","type":"object","additionalProperties":true},"native_voice_info":{"description":"Native voice track metadata when present.","type":"object","additionalProperties":true}},"example":{"note_id":"67f75b07000000000b0154b3","title":"Example public RedNote post","desc":"Example note description","type":"video","user":{"user_id":"creator-id","nickname":"Example creator"},"images_list":[{"width":1080,"height":1440,"url":"https://media.example/image.jpg"}],"interact_info":{"liked_count":"120","collected_count":"24"}}},"XiaohongshuPlatformResponse":{"type":"object","required":["status","data","msg"],"properties":{"status":{"type":"number","const":200},"data":{"type":"object","required":["media","platformData","platformDataVersion"],"properties":{"media":{"$ref":"#/components/schemas/Media"},"platformData":{"$ref":"#/components/schemas/XiaohongshuPlatformData"},"platformDataVersion":{"type":"string","const":"1","description":"Version of the published platformData contract."}}},"msg":{"type":"string","const":"success"}}},"BilibiliPlatformData":{"type":"object","description":"The final mainland Bilibili play object for the requested BV, av, bangumi, cheese, or supported list item. Documented fields are stable for platformDataVersion 1; additional sanitized public fields can also be present.","additionalProperties":true,"properties":{"title":{"description":"Public video title.","type":"string"},"pic":{"description":"Public cover image URL.","type":"string"},"timelength":{"description":"Duration in milliseconds.","type":"number"},"dash":{"description":"Separate DASH video and audio renditions.","type":"object","additionalProperties":true},"support_formats":{"description":"Quality labels and supported playback formats.","type":"array","items":{}},"quality":{"description":"Selected quality identifier when exposed.","type":"number"},"format":{"description":"Selected playback format when exposed.","type":"string"}},"example":{"title":"Example public Bilibili video","pic":"https://media.example/cover.jpg","timelength":65000,"dash":{"video":[{"id":80,"width":1920,"height":1080,"mimeType":"video/mp4","baseUrl":"https://media.example/video.m4s"}],"audio":[{"id":30280,"bandwidth":128000,"mimeType":"audio/mp4","baseUrl":"https://media.example/audio.m4s"}]},"support_formats":[{"quality":80,"new_description":"1080P"}]}},"BilibiliPlatformResponse":{"type":"object","required":["status","data","msg"],"properties":{"status":{"type":"number","const":200},"data":{"type":"object","required":["media","platformData","platformDataVersion"],"properties":{"media":{"$ref":"#/components/schemas/Media"},"platformData":{"$ref":"#/components/schemas/BilibiliPlatformData"},"platformDataVersion":{"type":"string","const":"1","description":"Version of the published platformData contract."}}},"msg":{"type":"string","const":"success"}}},"KuaishouPlatformData":{"type":"object","description":"The final Kuaishou/Kwai photo object selected by the requested photo identifier. Documented fields are stable for platformDataVersion 1; additional sanitized public fields can also be present.","additionalProperties":true,"properties":{"photoId":{"description":"Kuaishou or Kwai photo identifier.","type":"string"},"caption":{"description":"Public post caption.","type":"string"},"author":{"description":"Public creator profile fields.","type":"object","additionalProperties":true},"mainMvUrls":{"description":"Direct playable video renditions.","type":"array","items":{}},"manifest":{"description":"Adaptive stream metadata when exposed.","type":"object","additionalProperties":true},"coverUrls":{"description":"Public cover image candidates.","type":"array","items":{}},"duration":{"description":"Video duration reported by the platform.","type":"number"},"width":{"description":"Source video width.","type":"number"},"height":{"description":"Source video height.","type":"number"}},"example":{"photoId":"3x2cvn2u7fq8k8s","caption":"Example public Kuaishou video","author":{"name":"Example creator"},"mainMvUrls":[{"quality":"720p","url":"https://media.example/video.mp4"}],"coverUrls":[{"url":"https://media.example/cover.jpg"}],"duration":12000,"width":720,"height":1280}},"KuaishouPlatformResponse":{"type":"object","required":["status","data","msg"],"properties":{"status":{"type":"number","const":200},"data":{"type":"object","required":["media","platformData","platformDataVersion"],"properties":{"media":{"$ref":"#/components/schemas/Media"},"platformData":{"$ref":"#/components/schemas/KuaishouPlatformData"},"platformDataVersion":{"type":"string","const":"1","description":"Version of the published platformData contract."}}},"msg":{"type":"string","const":"success"}}},"WeiboPlatformData":{"type":"object","description":"The final Weibo status or video play object selected for the requested post. Documented fields are stable for platformDataVersion 1; additional sanitized public fields can also be present.","additionalProperties":true,"properties":{"id":{"description":"Weibo status identifier.","type":"string"},"mid":{"description":"Weibo numeric message identifier when exposed.","type":"string"},"mblogid":{"description":"Public short message identifier when exposed.","type":"string"},"text_raw":{"description":"Public plain-text post content.","type":"string"},"user":{"description":"Public author profile fields.","type":"object","additionalProperties":true},"pics":{"description":"All public image items attached to the post.","type":"array","items":{}},"page_info":{"description":"Video page title, cover, and media information.","type":"object","additionalProperties":true},"video_details_url":{"description":"Public video detail URL when exposed.","type":"string"}},"example":{"id":"5320188317925845","mid":"5320188317925845","text_raw":"Example public Weibo post","user":{"screen_name":"Example creator"},"pics":[{"large":{"url":"https://media.example/image.jpg"}}],"page_info":{"page_title":"Example video","media_info":{"mp4_hd_url":"https://media.example/video.mp4"}}}},"WeiboPlatformResponse":{"type":"object","required":["status","data","msg"],"properties":{"status":{"type":"number","const":200},"data":{"type":"object","required":["media","platformData","platformDataVersion"],"properties":{"media":{"$ref":"#/components/schemas/Media"},"platformData":{"$ref":"#/components/schemas/WeiboPlatformData"},"platformDataVersion":{"type":"string","const":"1","description":"Version of the published platformData contract."}}},"msg":{"type":"string","const":"success"}}}}}}