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.
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.
API Design Principles
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.
Semantic by Default
Every response includes titles, descriptions, keywords, and URIs — ready for knowledge graphs, vector databases, and LLM context.
Works Everywhere
Use it from your browser, your backend, or your scripts — no domain lock-ins and no extra setup.
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.
Public Endpoints
/api/v1/artistsEvery 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/api/v1/campaignsEvery 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=20Three 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)");
});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.
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