Music Data Studio API | Documentation

Use this endpoint to obtain an authentication token.

POST /auth/login

Headers:

  • Content-Type: application/json

Body:

{
    "email": "user@example.com",
    "password": "your_password"
}

Response:

{
    "token": "your_jwt_token_here"
}

Search for artists by name. Requires a valid JWT token.

GET /search?type=search&search={search term}

Headers:

  • Authorization: Bearer your_jwt_token

Parameters:

  • type (required): Set to search
  • search (optional): The artist's name to search for

Response:

[
    {
        "id": 1,
        "name": "Artist Name",
        "image": "artist_image_url",
        "slug": "artist-slug",
        "country": "artist_country"
    },
    ...
]

Retrieve details for an artist using their slug. Requires a valid JWT token.

GET /artist?slug={artist_slug}

Headers:

  • Authorization: Bearer your_jwt_token

Parameters:

  • slug (required): The unique identifier for the artist

Response:

{
            "id": 1,
            "name": "Artist Name",
            "image": "artist_image_url",
            "country": "artist_country",
            "tags": ["tag1", "tag2", ...],
            "socials": {
                "spotify": "spotify_url",
                "instagram": "instagram_url",
                ...
            },
            "similar": [
                {
                    "name": "Similar Artist Name",
                    "image": "similar_artist_image",
                    "country": "similar_artist_country",
                    "slug": "similar_artist_slug"
                },
                ...
            ]
        }

Retrieve detailed intelligence and analytics for an artist. Requires a valid JWT token.

GET /intelligence?uid={spotify_uid}&lang={language}&territory={territory}

Headers:

  • Authorization: Bearer your_jwt_token

Parameters:

  • uid (required): The unique Spotify identifier for the artist.
  • lang (optional): Language code for the response (e.g., en for English, fr for French).
  • territory (optional): Focus on a specific territory for the analysis (e.g., US, FR).

Response:

{
            "spotify": {
                "id": "spotify_artist_id",
                "name": "Artist Name",
                "genres": ["genre1", "genre2"],
                ...
            },
            "openAi": "Generated artist description and analysis in HTML format"
        }

This endpoint provides essential data about the artist’s Spotify profile and a descriptive analysis generated by OpenAI.