footage.cool: 4K Drone & Aerial Stock Footage

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'pace': {'anyOf': [{'enum': ['slow', 'balanced', 'fast'], 'type': 'string'}, {'type': 'null'}], 'description': 'Editing pace: slow (4 to 8s per clip), balanced (3 to 6s), fast (2 to 4s). Default balanced.'}, 'query': {'type': 'string', 'maxLength': 320, 'minLength': 1, 'description': "Description of the sequence, for example 'baja road trip along the coast' or 'whales and dolphins in the Sea of Cortez'."}, 'people': {'anyOf': [{'enum': ['any', 'with', 'none'], 'type': 'string'}, {'type': 'null'}], 'description': "Use 'none' for a people-free cut. Default any."}, 'year_to': {'anyOf': [{'type': 'integer', 'maximum': 2100, 'minimum': 1900}, {'type': 'null'}], 'description': 'Latest shot year.'}, 'category': {'anyOf': [{'type': 'string', 'maxLength': 80}, {'type': 'null'}], 'description': 'Optional scene category or curated slug, as in search_footage.'}, 'location': {'anyOf': [{'type': 'string', 'maxLength': 120}, {'type': 'null'}], 'description': 'Optional place filter.'}, 'year_from': {'anyOf': [{'type': 'integer', 'maximum': 2100, 'minimum': 1900}, {'type': 'null'}], 'description': 'Earliest shot year.'}, 'target_seconds': {'anyOf': [{'type': 'integer', 'maximum': 600, 'minimum': 20}, {'type': 'null'}], 'description': 'Target timeline length in seconds, 20 to 600 (default 60).'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['clip_id'], 'properties': {'clip_id': {'type': 'string', 'maxLength': 300, 'minLength': 1, 'description': 'The clip to check.'}, 'intended_use': {'anyOf': [{'type': 'string', 'maxLength': 40}, {'type': 'null'}], 'description': 'Intended use: commercial, editorial, documentary, internal_corporate, digital, broadcast, theatrical, or ai_training. Default commercial. AI training needs a separate data license.'}, 'expected_distribution': {'anyOf': [{'type': 'integer', 'maximum': 1000000000000, 'minimum': 0}, {'type': 'null'}], 'description': 'Optional expected views or copies. Above 1,000,000 needs the Extended license.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['quote_token', 'confirmed'], 'properties': {'confirmed': {'type': 'boolean', 'description': 'Set true only after the user explicitly approves the quoted clip, master resolution, license, price, and terms.'}, 'quote_token': {'type': 'string', 'maxLength': 2048, 'minLength': 20, 'description': 'Private quote_token returned by quote_4k_license. Never put it in public links or logs.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['clip_id'], 'properties': {'limit': {'anyOf': [{'type': 'integer', 'maximum': 24, 'minimum': 1}, {'type': 'null'}], 'description': 'Number of results, 1 to 24 (default 8).'}, 'clip_id': {'type': 'string', 'maxLength': 300, 'minLength': 1, 'description': 'Clip to find similar footage for (clip_id from search_footage).'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['order_token'], 'properties': {'order_token': {'type': 'string', 'maxLength': 2048, 'minLength': 20, 'description': 'Private order_token returned by create_4k_checkout. Keep it and the returned links private.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['clip_id'], 'properties': {'clip_id': {'type': 'string', 'maxLength': 300, 'minLength': 1, 'description': 'The clip_id returned by search_footage (numeric, or a filename-style id). A footage.cool clip URL also works.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['clip_id'], 'properties': {'clip_id': {'type': 'string', 'maxLength': 300, 'minLength': 1, 'description': 'The clip_id returned by search_footage (numeric, or a filename-style id). A footage.cool clip URL also works.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['clip_id', 'customer_email', 'license_type'], 'properties': {'clip_id': {'type': 'string', 'maxLength': 300, 'minLength': 1, 'description': 'The clip to license.'}, 'usage_scope': {'anyOf': [{'type': 'string', 'maxLength': 40}, {'type': 'null'}], 'description': 'Optional intended use (commercial, editorial, documentary, internal_corporate, digital, broadcast, theatrical). Broadcast and theatrical require rf_extended.'}, 'license_type': {'enum': ['rf_standard', 'rf_extended'], 'type': 'string', 'description': 'rf_standard: all media, worldwide, perpetual, up to 1,000,000 views or copies. rf_extended: adds unlimited distribution, broadcast TV, theatrical, and streaming originals. Let the user choose.'}, 'customer_email': {'type': 'string', 'maxLength': 254, 'minLength': 3, 'description': 'Buyer email for the license certificate and receipt. Ask the user; never invent one.'}, 'expected_distribution': {'anyOf': [{'type': 'integer', 'maximum': 1000000000000, 'minimum': 0}, {'type': 'null'}], 'description': 'Optional expected views or copies. Above 1,000,000 requires rf_extended.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'page': {'anyOf': [{'type': 'integer', 'maximum': 10000, 'minimum': 1}, {'type': 'null'}], 'description': 'Page number for more results (default 1).'}, 'sort': {'anyOf': [{'enum': ['relevance', 'newest', 'best', 'shortest', 'longest'], 'type': 'string'}, {'type': 'null'}], 'description': "Default 'relevance'. 'best' sorts by visual quality score."}, 'limit': {'anyOf': [{'type': 'integer', 'maximum': 50, 'minimum': 1}, {'type': 'null'}], 'description': 'Results per page, 1 to 50 (default 10).'}, 'query': {'type': 'string', 'maxLength': 320, 'minLength': 1, 'description': "What to find, in plain words. Descriptive works best: 'humpback whale breaching aerial', 'turquoise bay with boats cabo pulmo', 'desert highway at sunset'. Places and years in the query become filters."}, 'people': {'anyOf': [{'enum': ['any', 'with', 'none'], 'type': 'string'}, {'type': 'null'}], 'description': "'none' returns clips with no people flagged (easier commercial clearance), 'with' only clips with people. Default any."}, 'year_to': {'anyOf': [{'type': 'integer', 'maximum': 2100, 'minimum': 1900}, {'type': 'null'}], 'description': 'Latest shot year (for example 2023).'}, 'category': {'anyOf': [{'type': 'string', 'maxLength': 80}, {'type': 'null'}], 'description': 'Optional scene category (Aerial, Beach, Ocean, Wildlife, People, Road, Landscape, Desert, Urban, Sunset, Architecture, Nature, Mountain, Forest, Agriculture, Other) or a curated slug such as drone, underwater, whales, surfing, cabo-pulmo, los-cabos, colorado. get_catalog_overview lists all of them.'}, 'location': {'anyOf': [{'type': 'string', 'maxLength': 120}, {'type': 'null'}], 'description': 'Optional place filter matched against city, region, and country (for example "Cabo Pulmo", "Colorado", "Mexico").'}, 'year_from': {'anyOf': [{'type': 'integer', 'maximum': 2100, 'minimum': 1900}, {'type': 'null'}], 'description': 'Earliest shot year (for example 2019).'}, 'max_duration_seconds': {'anyOf': [{'type': 'integer', 'maximum': 3600, 'minimum': 0}, {'type': 'null'}], 'description': 'Longest clip length to include, in seconds.'}, 'min_duration_seconds': {'anyOf': [{'type': 'integer', 'maximum': 3600, 'minimum': 0}, {'type': 'null'}], 'description': 'Shortest clip length to include, in seconds.'}}, 'additionalProperties': False}