audivo-dev · Schema

ShowSearchResponse

CompanyPodcastsTranscriptsAudio

Properties

Name Type Description
data array
excluded array
next_cursor object Always `null`; the provider does not page this call.
View JSON Schema on GitHub

JSON Schema

audivo-dev-show-search-response-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/audivo-dev/json-schema/audivo-dev-show-search-response-schema.json",
  "title": "ShowSearchResponse",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/audivo-dev-catalog-api-openapi.yml#/components/schemas/ShowSearchResponse",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "data",
    "excluded",
    "next_cursor"
  ],
  "properties": {
    "data": {
      "type": "array",
      "maxItems": 100,
      "items": {
        "$ref": "#/$defs/ShowSummary"
      }
    },
    "excluded": {
      "type": "array",
      "maxItems": 100,
      "items": {
        "$ref": "#/$defs/DiscoveryExclusion"
      }
    },
    "next_cursor": {
      "$ref": "#/$defs/NullableCursor",
      "description": "Always `null`; the provider does not page this call."
    }
  },
  "$defs": {
    "Cursor": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,512}$",
      "description": "An opaque pagination cursor. Callers must treat it as opaque."
    },
    "DiscoveryExclusion": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "title",
        "reason",
        "detail"
      ],
      "description": "A provider entry a caller cannot act on, named rather than dropped: without a usable feed URL there is no `show_id` to derive and nothing to select. Present so a list never shrinks silently.",
      "properties": {
        "title": {
          "type": "string",
          "minLength": 1,
          "maxLength": 300
        },
        "reason": {
          "type": "string",
          "enum": [
            "no_feed_url",
            "invalid_feed_url"
          ]
        },
        "detail": {
          "type": "string",
          "minLength": 1,
          "maxLength": 1000
        }
      }
    },
    "FeedUrl": {
      "type": "string",
      "format": "uri",
      "minLength": 1,
      "maxLength": 2048,
      "description": "An RSS/Atom feed URL."
    },
    "NullableCursor": {
      "description": "An opaque pagination cursor, or `null` when there is no next page.",
      "anyOf": [
        {
          "$ref": "#/$defs/Cursor"
        },
        {
          "enum": [
            null
          ]
        }
      ]
    },
    "NullableUri": {
      "description": "A URL, or `null`.",
      "anyOf": [
        {
          "type": "string",
          "format": "uri",
          "maxLength": 2048
        },
        {
          "enum": [
            null
          ]
        }
      ]
    },
    "ShowId": {
      "type": "string",
      "pattern": "^sh_[a-z2-7]{16}$",
      "description": "Canonical show identifier."
    },
    "ShowSummary": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "show_id",
        "title",
        "feed_url",
        "itunes_id",
        "author",
        "categories",
        "artwork_url",
        "music_led",
        "music_led_basis"
      ],
      "description": "One show as a discovery surface returns it (search or chart), before any selection rule applies. `show_id` is derived from the provider's iTunes id when it carries one and from the feed URL otherwise, so it is stable across the two surfaces and the quote. `music_led` is the music-led marking: a coarse, show-level judgement from the provider's category labels — `music_led_basis` says which — that cannot see a music bed inside a talk show and over-excludes spoken commentary *about* music; the caller can opt back in when quoting.",
      "properties": {
        "show_id": {
          "$ref": "#/$defs/ShowId"
        },
        "title": {
          "type": "string",
          "minLength": 1,
          "maxLength": 300
        },
        "feed_url": {
          "$ref": "#/$defs/FeedUrl"
        },
        "itunes_id": {
          "description": "The iTunes collection ID, or `null` if the provider knows none.",
          "anyOf": [
            {
              "type": "integer",
              "minimum": 1
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "author": {
          "description": "The show's author as the provider carries it, or `null`.",
          "anyOf": [
            {
              "type": "string",
              "maxLength": 300
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "categories": {
          "type": "array",
          "maxItems": 50,
          "items": {
            "type": "string",
            "maxLength": 100
          },
          "description": "The provider's category names for the show, in provider order."
        },
        "artwork_url": {
          "$ref": "#/$defs/NullableUri"
        },
        "music_led": {
          "type": "boolean",
          "description": "Whether the show is music-led; see the schema description."
        },
        "music_led_basis": {
          "type": "string",
          "minLength": 1,
          "maxLength": 300,
          "description": "What `music_led` is based on, in words a caller can show."
        }
      }
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/audivo-dev-show-search-response"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.