EN|VI
← Back to Home

API Documentation

Comprehensive guides and endpoints

Endpoints

POST /api/embed/resolve

Takes a music URL and returns a normalized JSON object containing metadata and the final embed URL.

{
  "url": "https://open.spotify.com/track/..."
}

GET /api/oembed?url=...

Returns a standard oEmbed JSON response, useful for embedding in Discord, Notion, or other services.

GET /api/embed?url=...

Returns a raw HTML string with an optimized iframe ready to render on a webpage.

GET /api/react?url=...

Returns a pre-built React Component (TSX/JSX) structure ready to be embedded into any Next.js or React application.

GET /api/og?url=...

Returns a structured JSON object containing Open Graph tags.

GET /api/stream?url=...

Returns an active HTML card layout containing the media embed securely without middle-man referers. This URL can directly be used inside an iframe's src field.

GET /api/share?url=...

Returns an HTML page optimized for social sharing with Open Graph and Twitter Card tags. You can pass query parameters title, description, and image to customize the preview explicitly.