Find out how many hours of video on Graunt meet a spec, and in which categories. Give the requirements that matter (shortest side, frame rate, clip length, sound, on-screen text, overlays, first and last shots, freezes, slowed footage, releases, clearances, AI generation, uses, delivery); leave the rest out. Returns matching hours per category and per listing: hours that meet every requirement on recorded evidence, and hours that meet every requirement the evidence covers but lack evidence for one or more. Each listing carries its list price and any rate per hour and volume tier it is stored with, its hours per category with what each category alone costs where it sells by category, the spec's categories priced as one order, its delivery modes and where each number comes from. Thresholds snap to fixed steps and the answer says which were applied. Give hours_wanted to also get a proposal: whole listings across sellers that reach those hours on recorded evidence, lowest price per measured hour first, each at its seller's own price, for the person you work for to add to their cart. Nothing is held, and short_units is the gap the proposal leaves, not a statement about what Graunt holds.
View input schema
{
"type": "object",
"properties": {
"hours_wanted": {
"type": "number",
"description": "The hours you need across listings. The answer then carries a proposal: whole listings across sellers that reach them on recorded evidence, each at its seller's own price."
},
"q": {
"type": "string",
"description": "Words in the listing, as listing search reads them: an activity or subject the categories do not name. These are the seller's words."
},
"min_short_side_px": {
"type": "number",
"description": "Shortest side of the picture, at least (pixels): steps 240, 360, 480, 720, 1080, 1440, 2160, 4320."
},
"orientations": {
"type": "array",
"items": {
"type": "string",
"enum": [
"LANDSCAPE",
"PORTRAIT",
"SQUARE"
]
},
"description": "Picture orientations, any of."
},
"native_only": {
"type": "boolean",
"description": "Leave out clips with an upscale signal."
},
"min_fps": {
"type": "number",
"description": "Frames a second, at least: steps 24, 25, 30, 48, 50, 60, 120 (23.976 counts as 24)."
},
"min_clip_seconds": {
"type": "number",
"description": "Clip length, at least (seconds): steps 5, 10, 30, 60, 120, 300, 600, 1200, 3600, 14400."
},
"clip_seconds_under": {
"type": "number",
"description": "Clip length, under (seconds), on the same steps."
},
"audio": {
"type": "string",
"enum": [
"REQUIRED",
"NONE"
],
"description": "Sound required, or no sound."
},
"min_audio_sample_rate_hz": {
"type": "number",
"description": "Sound sample rate, at least: steps 44100, 48000, 96000."
},
"audio_checked": {
"type": "boolean",
"description": "The sound runs the length of the picture, with no dual mono and no silent channel."
},
"edge_shot_min_seconds": {
"type": "number",
"description": "Each clip's first and last shots last at least this long (seconds): steps 1, 2, 3, 5."
},
"max_cuts_per_minute": {
"type": "number",
"description": "Scene cuts a minute, at most: steps 0, 1, 2, 5, 10."
},
"text_area_under_pct": {
"type": "number",
"description": "On-screen text covers under this share of the frame (percent): steps 1, 2, 5, 10."
},
"text_seconds_under": {
"type": "number",
"description": "On-screen text stays on screen under this long (seconds): steps 0.5, 1, 2, 5."
},
"processed_area_under_pct": {
"type": "number",
"description": "Black bars and fixed overlays cover under this share of the frame (percent): steps 1, 5, 10."
},
"overlay_share_under_pct": {
"type": "number",
"description": "Clips with an overlay signal (a logo or watermark) stay under this share of a listing's matching hours (percent): steps 0, 5, 10, 20, 50."
},
"freeze_seconds_under": {
"type": "number",
"description": "No frozen stretch this long or longer (seconds): steps 0.5, 1, 2, 5."
},
"black_seconds_under": {
"type": "number",
"description": "Black under this long in total (seconds): steps 0.5, 1, 2, 5."
},
"no_loops": {
"type": "boolean",
"description": "Leave out clips with a stretch that repeats earlier footage."
},
"no_slowed": {
"type": "boolean",
"description": "Leave out clips with a slowed-footage signal."
},
"color_checked": {
"type": "boolean",
"description": "Color tags present and consistent, and luma inside the tagged range."
},
"no_grayscale": {
"type": "boolean",
"description": "Leave out black-and-white clips."
},
"subjects": {
"type": "array",
"items": {
"type": "string",
"enum": [
"PEOPLE_TALKING",
"PEOPLE_IN_ACTION",
"PEOPLE_HANDLING_OBJECTS",
"HOW_TO_AND_TASKS",
"SPORTS_AND_FITNESS",
"MUSIC_AND_PERFORMANCE",
"ANIMALS",
"NATURE",
"CITIES_AND_BUILDINGS",
"DRIVING_AND_TRANSPORTATION",
"INDUSTRY_AND_WORK_SITES",
"FOOD_AND_COOKING",
"PRODUCTS_AND_RETAIL",
"ANIMATION",
"VIDEO_GAMES"
]
},
"description": "What the footage shows, any of."
},
"camera_views": {
"type": "array",
"items": {
"type": "string",
"enum": [
"FIRST_PERSON",
"AERIAL_OR_DRONE",
"VEHICLE_OR_DASHCAM",
"FIXED_CAMERA",
"OTHER"
]
},
"description": "The camera view the listing declares, any of."
},
"people_on_camera": {
"type": "string",
"enum": [
"NONE",
"SUBJECT"
],
"description": "NONE: only clips with nobody on camera. SUBJECT: only clips with people as the subject."
},
"person_releases": {
"type": "string",
"enum": [
"SIGNED",
"ON_FILE"
],
"description": "Clips that show people need signed releases (SIGNED), or releases the seller holds (ON_FILE)."
},
"property_releases": {
"type": "string",
"enum": [
"SIGNED",
"ON_FILE"
],
"description": "Property releases where one is needed."
},
"music_cleared": {
"type": "boolean",
"description": "Music and audio cleared or not applicable."
},
"third_party_ip_cleared": {
"type": "boolean",
"description": "Logos and trademarks cleared or not applicable."
},
"event_venue_cleared": {
"type": "boolean",
"description": "Event or venue cleared or not applicable."
},
"no_identifiable_minors": {
"type": "boolean",
"description": "Leave out clips the seller says show identifiable minors."
},
"no_ai_generated": {
"type": "boolean",
"description": "Only clips the seller declares no AI model generated."
},
"delivery_modes": {
"type": "array",
"items": {
"type": "string",
"enum": [
"DOWNLOAD",
"LINKS",
"SEALED"
]
},
"description": "Delivery modes, any of: DOWNLOAD from Graunt, or LINKS or SEALED from the seller's storage."
},
"min_listing_hours": {
"type": "number",
"description": "Only listings with at least this many hours that meet the spec or might."
},
"uses": {
"type": "array",
"items": {
"type": "string",
"enum": [
"AI_TRAINING",
"COMMERCIAL_USE",
"REDISTRIBUTION"
]
},
"description": "Uses the listing must allow, all of."
},
"sublicense": {
"type": "string",
"enum": [
"NONE",
"ONE_CLIENT_PREAUTHORIZED"
],
"description": "ONE_CLIENT_PREAUTHORIZED: the listing must allow buying for one client, named privately at purchase (D-651)."
},
"limit": {
"type": "number",
"description": "Listings returned; default 50, cap 200. Totals and categories count every listing."
}
}
}