link.bridgebeats.lookup

atproto.pds.bridgebeats.link

Documentation

Result of parsing and looking up media links across supported music streaming providers.

main record

Result of parsing and looking up media links across supported music streaming providers.

Record Key any Any valid record key

Properties

lookedUpAt string datetime Required

ISO8601 timestamp of when this lookup was performed.

results array of ref #providerResult Required

Collection of lookup results from each provider that returned a match.

maxLength: 10 itemsminLength: 1 items
View raw schema 
{
  "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 object

Music metadata from a specific provider's API query.

Properties

artUrl string uri Optional

URL to the cover artwork image.

maxLength: 2000 bytes
artist string Required

Primary artist name for the track or album artist.

maxLength: 500 bytes
externalId string Optional

ISRC (for tracks) or UPC (for albums) identifier for cross-platform matching.

maxLength: 50 bytes
isAlbum boolean Optional

True for albums/EPs, false for individual tracks.

marketRegion string Required

ISO3166-1 alpha-2 country code for the market/storefront.

maxLength: 2 bytes
provider string Required

The streaming platform provider.

title string Required

Official title of the track or album as listed in the provider's catalog.

maxLength: 500 bytes
url string uri Required

Direct web link to the track or album on the provider's platform.

maxLength: 2000 bytes
View raw schema 
{
  "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."
}

Lexicon Garden

@