Count the hours of video that meet a spec
match_video_specFind 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.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "match_video_spec"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Words in the listing, as listing search reads them: an activity or subject the categories do not name. These are the seller's words. | |
| uses | No | Uses the listing must allow, all of. | |
| audio | No | Sound required, or no sound. | |
| limit | No | Listings returned; default 50, cap 200. Totals and categories count every listing. | |
| min_fps | No | Frames a second, at least: steps 24, 25, 30, 48, 50, 60, 120 (23.976 counts as 24). | |
| no_loops | No | Leave out clips with a stretch that repeats earlier footage. | |
| subjects | No | What the footage shows, any of. | |
| no_slowed | No | Leave out clips with a slowed-footage signal. | |
| sublicense | No | ONE_CLIENT_PREAUTHORIZED: the listing must allow buying for one client, named privately at purchase (D-651). | |
| native_only | No | Leave out clips with an upscale signal. | |
| camera_views | No | The camera view the listing declares, any of. | |
| hours_wanted | No | 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. | |
| no_grayscale | No | Leave out black-and-white clips. | |
| orientations | No | Picture orientations, any of. | |
| audio_checked | No | The sound runs the length of the picture, with no dual mono and no silent channel. | |
| color_checked | No | Color tags present and consistent, and luma inside the tagged range. | |
| music_cleared | No | Music and audio cleared or not applicable. | |
| delivery_modes | No | Delivery modes, any of: DOWNLOAD from Graunt, or LINKS or SEALED from the seller's storage. | |
| no_ai_generated | No | Only clips the seller declares no AI model generated. | |
| person_releases | No | Clips that show people need signed releases (SIGNED), or releases the seller holds (ON_FILE). | |
| min_clip_seconds | No | Clip length, at least (seconds): steps 5, 10, 30, 60, 120, 300, 600, 1200, 3600, 14400. | |
| people_on_camera | No | NONE: only clips with nobody on camera. SUBJECT: only clips with people as the subject. | |
| min_listing_hours | No | Only listings with at least this many hours that meet the spec or might. | |
| min_short_side_px | No | Shortest side of the picture, at least (pixels): steps 240, 360, 480, 720, 1080, 1440, 2160, 4320. | |
| property_releases | No | Property releases where one is needed. | |
| clip_seconds_under | No | Clip length, under (seconds), on the same steps. | |
| text_seconds_under | No | On-screen text stays on screen under this long (seconds): steps 0.5, 1, 2, 5. | |
| black_seconds_under | No | Black under this long in total (seconds): steps 0.5, 1, 2, 5. | |
| event_venue_cleared | No | Event or venue cleared or not applicable. | |
| max_cuts_per_minute | No | Scene cuts a minute, at most: steps 0, 1, 2, 5, 10. | |
| text_area_under_pct | No | On-screen text covers under this share of the frame (percent): steps 1, 2, 5, 10. | |
| freeze_seconds_under | No | No frozen stretch this long or longer (seconds): steps 0.5, 1, 2, 5. | |
| edge_shot_min_seconds | No | Each clip's first and last shots last at least this long (seconds): steps 1, 2, 3, 5. | |
| no_identifiable_minors | No | Leave out clips the seller says show identifiable minors. | |
| third_party_ip_cleared | No | Logos and trademarks cleared or not applicable. | |
| overlay_share_under_pct | No | 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. | |
| min_audio_sample_rate_hz | No | Sound sample rate, at least: steps 44100, 48000, 96000. | |
| processed_area_under_pct | No | Black bars and fixed overlays cover under this share of the frame (percent): steps 1, 5, 10. |