Example request

GET https://api.7digital.com/release/search?q=Test&oauth_consumer_key=YOUR_KEY_HERE&country=GB&pagesize=10&usageTypes=download,subscriptionstreaming,adsupportedstreaming

Example response

 {
  "estimatedTotalItems": 1,
  "page": 1,
  "expectedPageSize": 10,
  "results": [
    {
      "id": 2830094,
      "title": "TEST CONTENT",
      "subtitle": "",
      "upc": "7digtestcontent00",
      "explicitContent": false,
      "trackCount": 3,
      "year": 2013,
      "type": "Single",
      "availableFor": [
        "adSupportedStreaming",
        "download",
        "subscriptionStreaming"
      ],
      "artist": {
        "id": 574207,
        "name": "TEST CONTENT"
      },
      "licensor": {
        "id": 1386,
        "name": "Core Platform Test Group 2"
      },
      "label": {
        "id": 213079,
        "name": "7dig"
      },
      "packages": [
        {
          "id": 2,
          "name": "Standard",
          "price": {
            "currencyCode": "GBP",
            "rrp": "6.49"
          },
          "formats": [
            {
              "id": 17,
              "name": "MP3 320"
            }
          ]
        },
        {
          "id": 9,
          "name": "Premium",
          "price": {
            "currencyCode": "GBP",
            "rrp": "7.99"
          },
          "formats": [
            {
              "id": 45,
              "name": "FLAC 16-bit 44.1kHz"
            }
          ]
        }
      ],
      "popularity": 0.24,
      "score": 12.749599
    }
  ]
}

Results schema

 {
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "estimatedTotalItems": { "type": "integer" },
    "page": { "type": "integer" },
    "expectedPageSize": { "type": "integer" },
    "results": {
      "type": "array",
      "items": { "$ref": "#/definitions/release" }
    }
  },
  "required": ["estimatedTotalItems", "page", "expectedPageSize", "results"],
  "definitions": {
    "release": {
      "type": "object",
      "properties": {
        "id": { "type": "integer" },
        "title": { "type": "string" },
        "subtitle": { "type": "string" },
        "upc": { "type": "string" },
        "explicitContent": { "type": "boolean" },
        "trackCount": { "type": "integer" },
        "year": { "type": "integer" },
        "type": { "type": "string" },
        "availableFor": {
          "type": "array",
          "items": { "type": "string" }
        },
        "artist": { "$ref": "#/definitions/artist" },
        "licensor": { "$ref": "#/definitions/licensor" },
        "label": { "$ref": "#/definitions/label" },
        "packages": {
          "type": "array",
          "items": { "$ref": "#/definitions/package" }
        },
        "popularity": { "type": "number" },
        "score": { "type": "number" }
      },
      "required": ["id", "title", "subtitle", "upc", "explicitContent", "trackCount", "year", "type", "availableFor", "artist", "licensor", "label", "popularity", "score"]
    },
    "artist": {
      "type": "object",
      "properties": {
        "id": { "type": "integer" },
        "name": { "type": "string" }
      },
      "required": ["id", "name"]
    },
    "licensor": {
      "type": "object",
      "properties": {
        "id": { "type": "integer" },
        "name": { "type": "string" }
      },
      "required": ["id", "name"]
    },
    "label": {
      "type": "object",
      "properties": {
        "id": { "type": "integer" },
        "name": { "type": "string" }
      },
      "required": ["id", "name"]
    },
    "package": {
      "type": "object",
      "properties": {
        "id": { "type": "integer" },
        "name": { "type": "string" },
        "price": { "$ref": "#/definitions/price" },
        "formats": {
          "type": "array",
          "items": { "$ref": "#/definitions/format" }
        }
      },
      "required": ["id", "name", "price", "formats"]
    },
    "price": {
      "type": "object",
      "properties": {
        "currencyCode": { "type": "string" },
        "rrp": { "type": ["string", "null"] }
      },
      "required": ["currencyCode", "rrp"]
    },
    "format": {
      "type": "object",
      "properties": {
        "id": { "type": "integer" },
        "name": { "type": "string" }
      },
      "required": ["id", "name"]
    }
  }
}