Skip to content

Developers

Not Just for Humans

Our APIs are open and free — artist profiles and blog posts as structured JSON, ready for search engines, AI assistants, and your own projects.

2Endpoints
NoneAuth Required
OpenAccess
FreeCost
Commitment

The Machine Pledge

Many platforms make discovery harder by hiding useful artist information. We do the opposite: if an artist publishes on Music United, that information should be easy to find.

Our public APIs make discovery easier. Search for artists, explore blog posts, and access the details inside each one — open data that helps people find new music. Audio file links are never exposed through any API endpoint. Discovery data is open, while playback stays protected through the platform.

Search engines welcomeAI assistants welcomeDevelopers welcomeNo sign-up requiredClear structured dataAudio links protected
Philosophy

API Design Principles

01

No Auth Required

Open from day one. No API keys, no sign-up walls, and no setup steps. Fetch and go — every endpoint is publicly accessible.

02

Semantic by Default

Every response includes titles, descriptions, keywords, and URIs — ready for knowledge graphs, vector databases, and LLM context.

03

Works Everywhere

Use it from your browser, your backend, or your scripts — no domain lock-ins and no extra setup.

04

Cache-Friendly

Responses include cache headers so search tools and apps can stay fast and fresh. Built for scale from day one with predictable limits.

4 pillarsOpen by design
Reference

Public Endpoints

v1
GET/api/v1/artists

Every artist profile on Music United returned as structured, semantic JSON — designed for search engines, AI assistants, and third-party integrations. Open access with no sign-in required.

Parameters

  • ?q=<search> — filter by name, title, or keywords
  • ?limit=<n> — cap results (default 100, max 500)

Example

/api/v1/artists?q=electronic&limit=20
GET/api/v1/campaigns

Every published release on Music United — albums, EPs, singles, and artist campaigns — with full semantic metadata. Audio metadata (type, format) is included, but audio file links are never exposed.

Parameters

  • ?q=<search> — filter by title, description, or keywords (e.g. "dub", "ambient")
  • ?artist=<slug> — filter releases by artist topic slug
  • ?limit=<n> — cap results (default 100, max 500)

Example

/api/v1/campaigns?q=dub&limit=20
2 endpointsRead-only · No auth · CORS open
Quick Start

Three Lines of Code

No SDK, no package, no API key. Just fetch.

// Fetch every artist on Music United
const res = await fetch("https://musicunited.co/api/v1/artists");
const { results } = await res.json();

// Each result contains:
// { id, title, keywords, avatar_url, profile_url }
console.log(results);
// Search releases by keyword — metadata only, no audio file links
const res = await fetch("https://musicunited.co/api/v1/campaigns?q=dub");
const { results } = await res.json();

// Each result contains:
// { id, title, strap_line, call_to_action, description, keywords,
//   channel_slug, updated_at, campaign_url,
//   media: [{ type: "audio"|"video"|"image", url?, media_type }] }
// Note: audio entries never include a url — audio remains protected
console.log(results);
// Get all releases by a specific artist
const res = await fetch("https://musicunited.co/api/v1/campaigns?artist=my-topic");
const { results } = await res.json();

// Each release's media array contains metadata (type, format) but no audio links
results.forEach(c => {
  const tracks = c.media.filter(m => m.type === "audio");
  console.log(c.title, "—", tracks.length, "track(s)");
});
Use Cases

Built for Everyone Who Reads Data

AI Agents & LLMs

Feed our structured JSON into knowledge bases, recommendation tools, or chatbot context — rich artist and music metadata ready for discovery. Audio file links are never included.

Search Engines

Help search engines understand every artist and blog post clearly, so more listeners can discover the music faster.

Developers

Search for artists, browse their releases, and access metadata and images freely. Open by design — structured data you can build on, with full CORS support from any origin.

Promise

Your Data, Every Way We Can

“Every artist deserves to be found — by a person scrolling at midnight, by a search engine indexing the web, and by an AI answering questions. Our APIs make that possible.”

— The Music United team