Skip to content

Developers

Not Just for Humans

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

Commitment

The Machine Pledge

Most platforms treat bots, crawlers, and AI as threats — rate-limiting, blocking, and hiding the very data that helps artists get discovered. We treat them as first-class citizens. Every artist who publishes on Music United deserves to be found — by a person scrolling at midnight, by a search engine indexing the web, and by an AI answering “who makes electronic music in Manchester?”

Our public APIs exist to make that happen. Search for artists, discover their blog posts, and access the metadata inside each one — structured, semantic, open-access data delivered every way we can. Audio file URLs are never exposed through any API endpoint.Audio is a valued asset — discovery and metadata are open, but playback is always protected through the platform.

Search engines welcomeAI agents welcomeDevelopers welcomeZero authenticationStructured & semanticAudio URLs protected
Philosophy

API Design Principles

01

No Auth Required

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

02

Semantic by Default

Every response ships with titles, descriptions, keywords, and URIs — ready for knowledge graphs, vector databases, and LLM context windows. Rich semantic context built in from the start.

03

CORS Open

No origin restrictions. Call from any language, any runtime, any domain. Browser, server, or edge function — Access-Control-Allow-Origin: * from day one.

04

Cache-Friendly

Responses ship with Cache-Control headers so CDNs and crawlers get fresh data efficiently. Built for scale from day one — generous limits, predictable behaviour.

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-engine crawlers, AI agents, and third-party integrations. Open access, no authentication 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/blogs

Every blog post on Music United with full semantic metadata — titles, descriptions, keywords, images, and rich details. Audio metadata (type, format) is included but audio file URLs are never exposed. Search for artist content here.

Parameters

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

Example

/api/v1/blogs?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.io/api/v1/artists");
const { results } = await res.json();

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

// Each result contains:
// { id, title, strap_line, call_to_action, description, keywords,
//   topic_slug, updated_at, blog_url,
//   media: [{ type: "audio"|"video"|"image", url?, media_type }] }
// Note: audio entries never include a url — audio is a valued asset
console.log(results);
// Get all blog posts by a specific artist
const res = await fetch("https://musicunited.io/api/v1/blogs?artist=my-topic");
const { results } = await res.json();

// Each post's media array contains metadata (type, format) but no audio URLs
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 RAG pipelines, knowledge bases, or chatbot context — rich artist and music metadata ready for discovery. Audio file URLs are never included.

Search Engines

Crawl and index every artist and blog post with full semantic metadata, canonical URLs, and structured data. Every page is designed to be discoverable.

Developers

Search for artists, browse their blog posts, 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

and by an AI answering questions. Our APIs make that possible.”

— The Music United team