Video Grab

Use this when the user wants to search for a video they can reuse on a topic, such as ocean waves or a historical film with a free licence. Pass topic words.words Itin searchesquery, for example {"query": "ocean waves"}, and optionally sources and limit (1 to 5, default 5). Returns up to 5 hits from Wikimedia Commons and the Internet Archive and returns, aeach downloadwith linkdownload_url, the licence andas attributionthe forsource eachstates hit.it, Welicence_url doand notready-to-paste ripattribution. videos:When downloadingdownload_kind fromis TikTokdirectory, YouTube,download_url Instagram,is X,the Douyin,item's Bilibilifile orlist; Xiaohongshu,call orvideo_metadata strippingfor one direct file. Not for a watermark,known breaksitem those(use sites'video_metadata) terms.or Athe platformuser's URL,own auploads watermark(use request,own_video_export). orWe ado namednot ripperrip returnsvideos thatfrom explanationsocial andplatforms noor file.remove Pexelswatermarks. andA Pixabayplatform areURL, includeda onlywatermark whenrequest theiror keysa arenamed configured;ripper otherwisereturns thestatus answernot_offered sayswith theyan wereerror.hint notand searched.no file.

{"additionalProperties":false,"properties":{"limit":{"default":5,"description":"How many videos to return, 5 ⟨7 unchanged words⟩ integer"},"query":{"description":"Topic words,words. suchExample ascall: {\"query\": \"ocean waves.waves\"}. ANot a link: a TikTok, YouTube, Instagram, X or other platform URL isreturns refused.status not_offered and no file.","examples":["ocean waves","1930s newsreel"],"maxLength":200,"minLength":2,"type":"string"},"sources":{"descriptiondefault":["commons", "archive"]

 ⟨10 unchanged words⟩ ,"type":"string"},"count":{"description":"Number of results","type":"integer"},"error":{"description" ⟨15 unchanged words⟩ do next.","properties":{"code":{"description":"Stable code: not_offered, no_results, not_found, not_free or source_unavailable","type":"string"},"hint":{"description":"The next step: which tool to call or what input to change","type":"string"},"message":{"description":"What went wrong, in one or two sentences","type":"string"}},"required":["code ⟨17 unchanged words⟩ ,"type":"string"},"licence_note":{"description":"Reminder that the licence is what the source states","type":"string"},"notes":{"description":"Sources that were not searched or could not be read, such as Pexels without a key","items":{"type":"string"},"type":"array"},"query":{"description":"The query as searched","type":"string"},"results":{"items" ⟨25 unchanged words⟩ :"string"},"download_kind":{"description":"directoryfile: meansdownload_url theis source'sthe filevideo 

 ⟨24 unchanged words⟩ or a feature request to the maintainers of thesethe tools.tools on this server. Send it when a tool is missing, a ⟨36 unchanged words⟩ name. Returns a ticket id. Feedback is for thesethe tools on this server only: it is not a chat, and ⟨20 unchanged words⟩ 

 ⟨66 unchanged words⟩ ,"tool":{"description":"Optional: the exact name of the tool on this server that the feedback is about, foras exampletools/list find_tariff_codes.shows it.","pattern":"^[A-Za-z0-9_.:-]{1, ⟨9 unchanged words⟩ 

Video metadata and captions. Use this when the user hasnames one known video and wants its licence, attribution, metadata, captions or a Wikimediadirect file link. Pass ref: a Commons file title such as "File:Ocean_surface_waves_06.ogv", an Internet Archive identifier such as "cat_with_green_shining_eye" or its URL, or a YouTube watch URLURL. andReturns wantsdownload_url (the publicone record.link Passto thatgive reference.the Commonsuser: anda direct file, the Internetfile Archivelist returnwhen theno licencevideo file is listed, attributionor null), afiles download(every linkdirect andvideo anyand caption file thelisted) officialand metadatacaptions lists.(caption files only, vtt or srt). A YouTube URL returns the title and channel only, from oEmbed orwith theno Datadownload APIand whenno acaption keyfile. isAn configured,item with no download and no captionfree file.licence Wereturns donot_free notand ripno videos:link. downloadingNot fromfor TikTok,a YouTube,topic Instagram,search X,(use Douyin,search_free_videos). BilibiliWe ordo Xiaohongshu,not orrip strippingvideos afrom watermark,social breaksplatforms thoseor sites'remove terms.watermarks. A TikTok, Instagram, X, Douyin, Bilibili or Xiaohongshu link returns that explanationnot_offered and is not fetched.

{"additionalProperties":false,"properties":{"ref":{"description":"AOne Wikimediaitem. CommonsExample filecall: title{\"ref\": or\"File:Ocean_surface_waves_06.ogv\"}. Also a Commons page URL, an Internet Archive identifier (\"cat_with_green_shining_eye\") or details URL, or a YouTube watch URL","examples":["File:Ocean_surface_waves_06.ogv","cat_with_green_shining_eye","https://www.youtube.com/watch?v=jNQXAC9IVRw"],"maxLength":300,"minLength":2,"type" ⟨5 unchanged words⟩ 

{"properties":{"as_of":{"description":"Date of this answer (UTC, YYYY-MM-DD)","type":"string"},"attribution":{"description":"Ready to paste next to a reuse of the file","type":["string","null"]},"captions":{"description":"Caption files the source lists, each a direct link. Empty for Commons and YouTube","items":{"properties":{"format":{"description":"Caption file format: vtt (WebVTT) or srt (SubRip)","enum":["vtt","srt"],"type":"string"},"name":{"description":"Caption file name","type":"string"},"url":{"description":"Direct link to the caption file","format":"uri","type":"string"}},"required":["name","url","format"],"type":"object"},"maxItems":4,"type":"array"},"captions_note":{"description":"Why captions are or are not listed","type":"string"},"creator":{"description":"Creator or YouTube channel, or null when not stated","type":["string","null"]},"download_kind":{"description":"What download_url points to","enum":["file","directory","none"],"type":"string"},"download_url":{"description":"The one link to hand the user: a direct video file when download_kind is file, the item's file list when it is directory, and null when none (YouTube or a refusal)","format":"uri","type":["string","null"]},"error ⟨16 unchanged words⟩ do next.","properties":{"code":{"description":"Stable code: not_offered, no_results, not_found, not_free or source_unavailable","type":"string"},"hint":{"description":"The next step: which tool to call or what input to change","type":"string"},"message":{"description":"What went wrong, in one or two sentences","