{"openapi":"3.1.0","info":{"title":"Verified Footage API","description":"Search a library of verified, real, location-tagged real-world footage by natural-language description and retrieve thumbnail and download URLs. Free to use.","version":"1.0.0"},"servers":[{"url":"https://www.verifiedfootage.com"}],"paths":{"/api/search":{"get":{"operationId":"searchFootage","summary":"Search footage by natural-language description","description":"Returns clips ranked by semantic similarity to the query (e.g. \"aerial of a coastal city at golden hour\"). Use when an agent or user needs real stock footage to drop into a video.","parameters":[{"name":"q","in":"query","required":true,"description":"Natural-language description of the footage needed.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max clips to return (1-30, default 12).","schema":{"type":"integer","minimum":1,"maximum":30,"default":12}}],"responses":{"200":{"description":"Ranked list of matching clips.","content":{"application/json":{"schema":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Unique clip id."},"title":{"type":"string"},"description":{"type":["string","null"],"description":"AI-generated caption of the footage."},"location":{"type":"string","description":"Where it was shot, e.g. \"Soho, New York\"."},"duration_seconds":{"type":["number","null"]},"orientation":{"type":"string","enum":["horizontal","vertical"]},"keywords":{"type":"array","items":{"type":"string"}},"thumbnail_url":{"type":"string","format":"uri"},"download_url":{"type":"string","format":"uri","description":"Direct MP4 download."},"page_url":{"type":"string","format":"uri"},"license":{"type":"string"}}}}}}}}}}}},"/api/clips/{id}":{"get":{"operationId":"getClip","summary":"Get a single clip by id","parameters":[{"name":"id","in":"path","required":true,"description":"The clip id returned by searchFootage.","schema":{"type":"string"}}],"responses":{"200":{"description":"The clip.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Unique clip id."},"title":{"type":"string"},"description":{"type":["string","null"],"description":"AI-generated caption of the footage."},"location":{"type":"string","description":"Where it was shot, e.g. \"Soho, New York\"."},"duration_seconds":{"type":["number","null"]},"orientation":{"type":"string","enum":["horizontal","vertical"]},"keywords":{"type":"array","items":{"type":"string"}},"thumbnail_url":{"type":"string","format":"uri"},"download_url":{"type":"string","format":"uri","description":"Direct MP4 download."},"page_url":{"type":"string","format":"uri"},"license":{"type":"string"}}}}}},"404":{"description":"Clip not found."}}}}}}