MetadataSoundSearchRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/coactive/main/json-schema/coactive-search-metadata-filter-metadata-sound-search-request-schema.json",
  "title": "MetadataSoundSearchRequest",
  "description": "Body for audio sound-class metadata-filter search.",
  "x-generated": "2026-10-20",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/coactive-search-metadata-filter-api-openapi.yml#/components/schemas/search-metadata-filter_MetadataSoundSearchRequest",
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 40,
      "description": "Max number of results to return"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "description": "Number of results to skip before returning"
    },
    "metadata_filters": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/search-metadata-filter_MetadataFilter"
      },
      "description": "List of filter objects applied against asset metadata fields before scoring. All filters are combined with AND."
    },
    "skip_moderation": {
      "type": "boolean",
      "default": false,
      "description": "When true, moderation scoring is skipped and moderation_score will be null on all results."
    },
    "dataset_id": {
      "type": "string",
      "format": "uuid",
      "description": "Dataset to search within"
    },
    "audio_class": {
      "$ref": "#/$defs/search-metadata-filter_AudioClass",
      "description": "AudioSet sound class label to search for (e.g. AudioClass.DOG, AudioClass.MUSIC)"
    }
  },
  "required": [
    "dataset_id",
    "audio_class"
  ],
  "$defs": {
    "search-metadata-filter_AudioClass": {
      "type": "string",
      "enum": [
        "Speech",
        "Male speech, man speaking",
        "Female speech, woman speaking",
        "Child speech, kid speaking",
        "Conversation",
        "Narration, monologue",
        "Babbling",
        "Speech synthesizer",
        "Shout",
        "Bellow",
        "Whoop",
        "Yell",
        "Battle cry",
        "Children shouting",
        "Screaming",
        "Whispering",
        "Laughter",
        "Baby laughter",
        "Giggle",
        "Snicker",
        "Belly laugh",
        "Chuckle, chortle",
        "Crying, sobbing",
        "Baby cry, infant cry",
        "Whimper",
        "Wail, moan",
        "Sigh",
        "Singing",
        "Choir",
        "Yodeling",
        "Chant",
        "Mantra",
        "Male singing",
        "Female singing",
        "Child singing",
        "Synthetic singing",
        "Rapping",
        "Humming",
        "Groan",
        "Grunt",
        "Whistling",
        "Breathing",
        "Wheeze",
        "Snoring",
        "Gasp",
        "Pant",
        "Snort",
        "Cough",
        "Throat clearing",
        "Sneeze",
        "Sniff",
        "Run",
        "Shuffle",
        "Walk, footsteps",
        "Chewing, mastication",
        "Biting",
        "Gargling",
        "Stomach rumble",
        "Burping, eructation",
        "Hiccup",
        "Fart",
        "Hands",
        "Finger snapping",
        "Clapping",
        "Heart sounds, heartbeat",
        "Heart murmur",
        "Cheering",
        "Applause",
        "Chatter",
        "Crowd",
        "Hubbub, speech noise, speech babble",
        "Children playing",
        "Animal",
        "Domestic animals, pets",
        "Dog",
        "Bark",
        "Yip",
        "Howl",
        "Bow-wow",
        "Growling",
        "Whimper (dog)",
        "Cat",
        "Purr",
        "Meow",
        "Hiss",
        "Caterwaul",
        "Livestock, farm animals, working animals",
        "Horse",
        "Clip-clop",
        "Neigh, whinny",
        "Cattle, bovinae",
        "Moo",
        "Cowbell",
        "Pig",
        "Oink",
        "Goat",
        "Bleat",
        "Sheep",
        "Fowl",
        "Chicken, rooster",
        "Cluck",
        "Crowing, cock-a-doodle-doo",
        "Turkey",
        "Gobble",
        "Duck",
        "Quack",
        "Goose",
        "Honk",
        "Wild animals",
        "Roaring cats (lions, tigers)",
        "Roar",
        "Bird",
        "Bird vocalization, bird call, bird song",
        "Chirp, tweet",
        "Squawk",
        "Pigeon, dove",
        "Coo",
        "Crow",
        "Caw",
        "Owl",
        "Hoot",
        "Bird flight, flapping wings",
        "Canidae, dogs, wolves",
        "Rodents, rats, mice",
        "Mouse",
        "Patter",
        "Insect",
        "Cricket",
        "Mosquito",
        "Fly, housefly",
        "Buzz",
        "Bee, wasp, etc.",
        "Frog",
        "Croak",
        "Snake",
        "Rattle",
        "Whale vocalization",
        "Music",
        "Musical instrument",
        "Plucked string instrument",
        "Guitar",
        "Electric guitar",
        "Bass guitar",
        "Acoustic guitar",
        "Steel guitar, slide guitar",
        "Tapping (guitar technique)",
        "Strum",
        "Banjo",
        "Sitar",
        "Mandolin",
        "Zither",
        "Ukulele",
        "Keyboard (musical)",
        "Piano",
        "Electric piano",
        "Organ",
        "Electronic organ",
        "Hammond organ",
        "Synthesizer",
        "Sampler",
        "Harpsichord",
        "Percussion",
        "Drum kit",
        "Drum machine",
        "Drum",
        "Snare drum",
        "Rimshot",
        "Drum roll",
        "Bass drum",
        "Timpani",
        "Tabla",
        "Cymbal",
        "Hi-hat",
        "Wood block",
        "Tambourine",
        "Rattle (instrument)",
        "Maraca",
        "Gong",
        "Tubular bells",
        "Mallet percussion",
        "Marimba, xylophone",
        "Glockenspiel",
        "Vibraphone",
        "Steelpan",
        "Orchestra",
        "Brass instrument",
        "French horn",
        "Trumpet",
        "Trombone",
        "Bowed string instrument",
        "String section",
        "Violin, fiddle",
        "Pizzicato",
        "Cello",
        "Double bass",
        "Wind instrument, woodwind instrument",
        "Flute",
        "Saxophone",
        "Clarinet",
        "Harp",
        "Bell",
        "Church bell",
        "Jingle bell",
        "Bicycle bell",
        "Tuning fork",
        "Chime",
        "Wind chime",
        "Change ringing (campanology)",
        "Harmonica",
        "Accordion",
        "Bagpipes",
        "Didgeridoo",
        "Shofar",
        "Theremin",
        "Singing bowl",
        "Scratching (performance technique)",
        "Pop music",
        "Hip hop music",
        "Beatboxing",
        "Rock music",
        "Heavy metal",
        "Punk rock",
        "Grunge",
        "Progressive rock",
        "Rock and roll",
        "Psychedelic rock",
        "Rhythm and blues",
        "Soul music",
        "Reggae",
        "Country",
        "Swing music",
        "Bluegrass",
        "Funk",
        "Folk music",
        "Middle Eastern music",
        "Jazz",
        "Disco",
        "Classical music",
        "Opera",
        "Electronic music",
        "House music",
        "Techno",
        "Dubstep",
        "Drum and bass",
        "Electronica",
        "Electronic dance music",
        "Ambient music",
        "Trance music",
        "Music of Latin America",
        "Salsa music",
        "Flamenco",
        "Blues",
        "Music for children",
        "New-age music",
        "Vocal music",
        "A capella",
        "Music of Africa",
        "Afrobeat",
        "Christian music",
        "Gospel music",
        "Music of Asia",
        "Carnatic music",
        "Music of Bollywood",
        "Ska",
        "Traditional music",
        "Independent music",
        "Song",
        "Background music",
        "Theme music",
        "Jingle (music)",
        "Soundtrack music",
        "Lullaby",
        "Video game music",
        "Christmas music",
        "Dance music",
        "Wedding music",
        "Happy music",
        "Funny music",
        "Sad music",
        "Tender music",
        "Exciting music",
        "Angry music",
        "Scary music",
        "Wind",
        "Rustling leaves",
        "Wind noise (microphone)",
        "Thunderstorm",
        "Thunder",
        "Water",
        "Rain",
        "Raindrop",
        "Rain on surface",
        "Stream",
        "Waterfall",
        "Ocean",
        "Waves, surf",
        "Steam",
        "Gurgling",
        "Fire",
        "Crackle",
        "Vehicle",
        "Boat, Water vehicle",
        "Sailboat, sailing ship",
        "Rowboat, canoe, kayak",
        "Motorboat, speedboat",
        "Ship",
        "Motor vehicle (road)",
        "Car",
        "Vehicle horn, car horn, honking",
        "Toot",
        "Car alarm",
        "Power windows, electric windows",
        "Skidding",
        "Tire squeal",
        "Car passing by",
        "Race car, auto racing",
        "Truck",
        "Air brake",
        "Air horn, truck horn",
        "Reversing beeps",
        "Ice cream truck, ice cream van",
        "Bus",
        "Emergency vehicle",
        "Police car (siren)",
        "Ambulance (siren)",
        "Fire engine, fire truck (siren)",
        "Motorcycle",
        "Traffic noise, roadway noise",
        "Rail transport",
        "Train",
        "Train whistle",
        "Train horn",
        "Railroad car, train wagon",
        "Train wheels squealing",
        "Subway, metro, underground",
        "Aircraft",
        "Aircraft engine",
        "Jet engine",
        "Propeller, airscrew",
        "Helicopter",
        "Fixed-wing aircraft, airplane",
        "Bicycle",
        "Skateboard",
        "Engine",
        "Light engine (high frequency)",
        "Dental drill, dentist's drill",
        "Lawn mower",
        "Chainsaw",
        "Medium engine (mid frequency)",
        "Heavy engine (low frequency)",
        "Engine knocking",
        "Engine starting",
        "Idling",
        "Accelerating, revving, vroom",
        "Door",
        "Doorbell",
        "Ding-dong",
        "Sliding door",
        "Slam",
        "Knock",
        "Tap",
        "Squeak",
        "Cupboard open or close",
        "Drawer open or close",
        "Dishes, pots, and pans",
        "Cutlery, silverware",
        "Chopping (food)",
        "Frying (food)",
        "Microwave oven",
        "Blender",
        "Water tap, faucet",
        "Sink (filling or washing)",
        "Bathtub (filling or washing)",
        "Hair dryer",
        "Toilet flush",
        "Toothbrush",
        "Electric toothbrush",
        "Vacuum cleaner",
        "Zipper (clothing)",
        "Keys jangling",
        "Coin (dropping)",
        "Scissors",
        "Electric shaver, electric razor",
        "Shuffling cards",
        "Typing",
        "Typewriter",
        "Computer keyboard",
        "Writing",
        "Alarm",
        "Telephone",
        "Telephone bell ringing",
        "Ringtone",
        "Telephone dialing, DTMF",
        "Dial tone",
        "Busy signal",
        "Alarm clock",
        "Siren",
        "Civil defense siren",
        "Buzzer",
        "Smoke detector, smoke alarm",
        "Fire alarm",
        "Foghorn",
        "Whistle",
        "Steam whistle",
        "Mechanisms",
        "Ratchet, pawl",
        "Clock",
        "Tick",
        "Tick-tock",
        "Gears",
        "Pulleys",
        "Sewing machine",
        "Mechanical fan",
        "Air conditioning",
        "Cash register",
        "Printer",
        "Camera",
        "Single-lens reflex camera",
        "Tools",
        "Hammer",
        "Jackhammer",
        "Sawing",
        "Filing (rasp)",
        "Sanding",
        "Power tool",
        "Drill",
        "Explosion",
        "Gunshot, gunfire",
        "Machine gun",
        "Fusillade",
        "Artillery fire",
        "Cap gun",
        "Fireworks",
        "Firecracker",
        "Burst, pop",
        "Eruption",
        "Boom",
        "Wood",
        "Chop",
        "Splinter",
        "Crack",
        "Glass",
        "Chink, clink",
        "Shatter",
        "Liquid",
        "Splash, splatter",
        "Slosh",
        "Squish",
        "Drip",
        "Pour",
        "Trickle, dribble",
        "Gush",
        "Fill (with liquid)",
        "Spray",
        "Pump (liquid)",
        "Stir",
        "Boiling",
        "Sonar",
        "Arrow",
        "Whoosh, swoosh, swish",
        "Thump, thud",
        "Thunk",
        "Electronic tuner",
        "Effects unit",
        "Chorus effect",
        "Basketball bounce",
        "Bang",
        "Slap, smack",
        "Whack, thwack",
        "Smash, crash",
        "Breaking",
        "Bouncing",
        "Whip",
        "Flap",
        "Scratch",
        "Scrape",
        "Rub",
        "Roll",
        "Crushing",
        "Crumpling, crinkling",
        "Tearing",
        "Beep, bleep",
        "Ping",
        "Ding",
        "Clang",
        "Squeal",
        "Creak",
        "Rustle",
        "Whir",
        "Clatter",
        "Sizzle",
        "Clicking",
        "Clickety-clack",
        "Rumble",
        "Plop",
        "Jingle, tinkle",
        "Hum",
        "Zing",
        "Boing",
        "Crunch",
        "Silence",
        "Sine wave",
        "Harmonic",
        "Chirp tone",
        "Sound effect",
        "Pulse",
        "Inside, small room",
        "Inside, large room or hall",
        "Inside, public space",
        "Outside, urban or manmade",
        "Outside, rural or natural",
        "Reverberation",
        "Echo",
        "Noise",
        "Environmental noise",
        "Static",
        "Mains hum",
        "Distortion",
        "Sidetone",
        "Cacophony",
        "White noise",
        "Pink noise",
        "Throbbing",
        "Vibration",
        "Television",
        "Radio",
        "Field recording"
      ],
      "description": "AudioSet audio class labels (527 classes)",
      "title": "AudioClass"
    },
    "search-metadata-filter_MetadataFilter": {
      "type": "object",
      "properties": {
        "key": {
          "type": "string",
          "description": "Name of the metadata field to filter on (must exist on the dataset's assets)."
        },
        "value": {
          "type": "string",
          "description": "Value to compare the metadata field against. Always provided as a string; numerical operators (>, <, >=, <=) parse it as a number."
        },
        "op": {
          "$ref": "#/$defs/search-metadata-filter_MetadataFilterOperator",
          "description": "Comparison operator. Defaults to `=` (equality)."
        }
      },
      "required": [
        "key",
        "value"
      ],
      "description": "A single filter applied against an asset metadata field before scoring.",
      "title": "MetadataFilter"
    },
    "search-metadata-filter_MetadataFilterOperator": {
      "type": "string",
      "enum": [
        "=",
        "!=",
        "contains",
        ">",
        "<",
        ">=",
        "<="
      ],
      "description": "Comparison operator applied between a metadata field value and the filter `value`.",
      "title": "MetadataFilterOperator"
    }
  }
}