link.bridgebeats.lookup

{
  "id": "link.bridgebeats.lookup",
  "defs": {
    "main": {
      "key": "any",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "results",
          "lookedUpAt"
        ],
        "properties": {
          "results": {
            "type": "array",
            "items": {
              "ref": "#providerResult",
              "type": "ref"
            },
            "maxLength": 10,
            "minLength": 1,
            "description": "Collection of lookup results from each provider that returned a match."
          },
          "lookedUpAt": {
            "type": "string",
            "format": "datetime",
            "description": "ISO8601 timestamp of when this lookup was performed."
          }
        }
      },
      "description": "Result of parsing and looking up media links across supported music streaming providers."
    },
    "providerResult": {
      "type": "object",
      "required": [
        "provider",
        "artist",
        "title",
        "url",
        "marketRegion"
      ],
      "properties": {
        "url": {
          "type": "string",
          "format": "uri",
          "maxLength": 2000,
          "description": "Direct web link to the track or album on the provider's platform."
        },
        "title": {
          "type": "string",
          "maxLength": 500,
          "description": "Official title of the track or album as listed in the provider's catalog."
        },
        "artUrl": {
          "type": "string",
          "format": "uri",
          "maxLength": 2000,
          "description": "URL to the cover artwork image."
        },
        "artist": {
          "type": "string",
          "maxLength": 500,
          "description": "Primary artist name for the track or album artist."
        },
        "isAlbum": {
          "type": "boolean",
          "description": "True for albums/EPs, false for individual tracks."
        },
        "provider": {
          "enum": [
            "appleMusic",
            "spotify",
            "tidal"
          ],
          "type": "string",
          "description": "The streaming platform provider."
        },
        "externalId": {
          "type": "string",
          "maxLength": 50,
          "description": "ISRC (for tracks) or UPC (for albums) identifier for cross-platform matching."
        },
        "marketRegion": {
          "type": "string",
          "default": "us",
          "maxLength": 2,
          "description": "ISO3166-1 alpha-2 country code for the market/storefront."
        }
      },
      "description": "Music metadata from a specific provider's API query."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1,
  "description": "Unified BridgeBeats lookup result aggregating links across music service providers."
}