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.
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.
API Design Principles
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.
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.
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.
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.
Public Endpoints
/api/v1/artistsEvery 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/api/v1/blogsEvery 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=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.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)");
});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.
Your Data, Every Way We Can
and by an AI answering questions. Our APIs make that possible.”
— The Music United team