Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

7digital Releases API

Browse, search, recommend, and chart 7digital releases (albums, singles, EPs).

7digital Releases API is one of 23 APIs that 7digital publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 2 JSON Schema definitions.

Tagged areas include Releases. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, a JSON-LD context, code examples, and 2 JSON Schemas.

This API exposes 11 operations across 11 paths, and defines 12 schemas. It is described by OpenAPI 3.0.3, at version 1.2.

Requests are made against a single base URL, https://api.7digital.com/1.2.

11 operations 11 paths 12 schemas 11 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.2
Base URL
https://api.7digital.com/1.2
Authentication
API Key, API Key, API Key
Resource Areas
1

Authentication & Security 3

7digital Releases API declares 3 security schemes for authenticating requests. An API key is passed in the query as oauth_consumer_key (oauth1). An API key is passed in the query as oauth_consumer_key (oauth1_two_legged). An API key is passed in the query as oauth_consumer_key (oauth1_three_legged). By default, every request must be authenticated.

  • oauth1 — 7digital uses OAuth 1.0 signing. Every request MUST include oauthconsumerkey as either a query parameter or in the Authorization header. Sensitive operations r…
  • oauth1_two_legged — 2-legged OAuth 1.0 (partner-scoped — consumer key + secret only).
  • oauth1_three_legged — 3-legged OAuth 1.0 (consumer key + secret plus a user access token + secret).

Paths & Operations 11

Across 11 paths, the API surfaces 11 operations — 11 GET. Each is listed below with its method, path, parameters, and response codes.

Releases 11

Browse, search, recommend, and chart 7digital releases (albums, singles, EPs).

GET
/release/byDate
7digital Get Releases By Date
getReleasesByDate 3 params → 200400401
GET
/release/details
7digital Get Release Details
getReleaseDetails 2 params → 200401404
GET
/release/editorial
7digital Get Release Editorial
getReleaseEditorial 1 param → 200
GET
/release/chart
7digital Get Release Chart
getReleaseChart 4 params → 200
GET
/release/recommend
7digital Get Release Recommendations
getReleaseRecommendations 3 params → 200
GET
/release/search
7digital Search Releases
searchReleases 4 params → 200
GET
/release/tracks
7digital Get Release Tracks
getReleaseTracks 1 param → 200
GET
/release/tags
7digital Get Release Tags
getReleaseTags 1 param → 200
GET
/release/match/byId
7digital Match Release By Id
matchReleaseById 1 param → 200
GET
/release/bytag/new
7digital Get New Releases By Tags
getNewReleasesByTags 4 params → 200
GET
/release/bytag/top
7digital Get Top Releases By Tags
getTopReleasesByTags 4 params → 200

Schemas 12

The contract defines 12 schemas that model the data the API accepts and returns. The most detailed are Release (12 properties), Track (11 properties), EditorialItem (6 properties), Artist (6 properties). Each schema is shown below with its type and property counts.

Tag
object
A genre/tag label.
3 properties
Release
object
A 7digital release (album, single, EP, compilation).
12 properties
Track
object
A 7digital track.
11 properties
TagListResponse
object
2 properties
ErrorResponse
object
Standard 7digital error envelope.
2 properties
EditorialResponse
object
2 properties
ReleaseListResponse
object
5 properties
Artist
object
A 7digital artist.
6 properties
Price
object
A price quoted in the requested territory's currency.
3 properties
EditorialItem
object
6 properties
TrackListResponse
object
5 properties
ReleaseDetailsResponse
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

7digital-releases-api-openapi.yml Raw ↑

Other APIs 7digital publishes across the network.

7digital Artists API
7digital Basket API
7digital Catalogue API
7digital Content Delivery API
7digital Download Purchases API
7digital Editorial API
7digital Interactive Radio API
7digital IpLookup API
7digital Logging API
7digital Offline Devices API
7digital Payment API
7digital Playlists API