Music Story API

openapi: 3.1.0
info:
  title: Music Story API
  version: '2026-10-12'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-12: 4 operation(s) read from 3 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Music Story has published no machine-readable contract that the
    pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 2
    documentation: 2
    pages-with-code: 3
    pages-read: 3
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-12'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://doc.music-story.com/api/reference
  - https://doc.music-story.com/ja/api/reference
  - https://doc.music-story.com/ko/api/reference
servers:
- url: https://api.v2.music-story.com
paths:
  /:
    get:
      operationId: get
      tags:
      - Api
      summary: GET /
      x-source: https://doc.music-story.com/ja/api/reference
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl]( https://curl.se/ ) (推奨、コマンドライン) \n ReqBIN]( https://reqbin.com/ ) (推奨、オンライン) \n Postman]( https://www.postman.com/downloads/\
          \ ) \n Insomnia]( https://insomnia.rest/ ) \n はじめに 最初のステップは、Music StoryのプラットフォームであるMetadata Monitorにアカウントを作成することです。 \n 私たちのAPIで利用可能なメタデータのビジュアル・バージョン以上のもので、以下のようなサービスを備えた専用のAPIセクションにアクセスできます：\
          \ \n APIコール数の確認 \n トークン情報の取得 \n APIステータスの確認 \n 弊社サポートチームへのお問い合わせ \n どのようにAPIをテストできますか？ \n 1"
  /api/artist/{id}:
    get:
      operationId: get_api_artist_id
      tags:
      - Api
      summary: Get Music Story artist
      description: Get Music Story artist
      x-source: https://doc.music-story.com/api/reference
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiArtistIdResponse'
      x-evidence:
        kind: documentation
  /api/artist/{id}/{id}:
    get:
      operationId: get_api_artist_id_id
      tags:
      - Api
      summary: Get Music Story artist albums
      description: Get Music Story artist albums
      x-source: https://doc.music-story.com/api/reference
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: offset
        in: query
        required: false
        schema:
          type: integer
        description: Offset number
      - name: limit
        in: query
        required: false
        schema:
          type: integer
        description: Limit number
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiArtistIdIdResponse'
      x-evidence:
        kind: documentation
        collapsed_from: 4 example path(s) differing only at id
  /api/{apiid}:
    get:
      operationId: get_api_apiid
      tags:
      - Api
      summary: Search Music Story album
      description: All endpoints to get albums data
      x-source: https://doc.music-story.com/api/reference
      parameters:
      - name: apiid
        in: path
        required: true
        schema:
          type: string
      - name: query
        in: query
        required: true
        schema:
          type: string
        description: Name or ID of Album to search
      - name: page
        in: query
        required: false
        schema:
          type: integer
        description: Page number
      - name: release_date
        in: query
        required: false
        schema:
          type: string
        description: Release date to filter results
      - name: artist
        in: query
        required: false
        schema:
          type: string
        description: Artist name to filter results
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiApiidResponse'
      x-evidence:
        kind: documentation
        collapsed_from: 2 example path(s) differing only at apiId
components:
  schemas:
    GetApiArtistIdResponse:
      type: object
      properties:
        id:
          type: integer
          description: Basic ID of the artist
        name:
          type: string
          description: Basic Full name of the artist
        isni:
          type: string
          description: Basic ISNI of the artist
        real_firstname_lastname:
          type: string
          description: Basic Real name of the artist
        type:
          type: string
          description: Basic Type of artist
        nature:
          type: string
          description: Basic Nature of artist
        gender:
          type: string
          description: Basic Gender of the artist
        main_role:
          type: number
          description: Deprecated Basic ID of the main role of the artist
        country_name:
          type: string
          description: Basic Name of the artist’s country
        country_code:
          type: string
          description: Basic Two-letter code of the artist’s country
        influence_country_name:
          type: string
          description: Basic Name of the country that influenced the artist the most
        influence_country_code:
          type: string
          description: Basic Two-letter code of the country that influenced the artist the most
        birth_date:
          type: string
          description: Bio Artist’s date of birth
        debut_date:
          type: string
          description: Bio Artist’s debut date
        birth_place:
          type: string
          description: Bio Artist’s place of birth
        activity_periods:
          type: array
          description: Bio Array containing the artist’s activity periods
        death_date:
          type: string
          description: Bio Artist’s date of death
        death_place:
          type: string
          description: Bio Artist’s place of death
        genres:
          type: array
          description: Array containing the artist’s genres
        roles:
          type: array
          description: Array containing the artist’s roles
        aliases:
          type: array
          description: Array containing the artist’s aliases
        translated:
          type: array
          description: Array containing the artist’s translated names
        band_members:
          type: array
          description: Array containing the band members
        related_artists:
          type: array
          description: Array containing the related artists
        collaborators:
          type: array
          description: Array containing the artist’s collaborators
        socials:
          type: object
          description: Basic Object containing external links related to the artist
        externals:
          type: object
          description: Basic / External Object containing the IDs of the artist in external databases and platforms
        famous_for:
          type: string
          description: Bio Blurb describing why the artist is well known
        awards:
          type: string
          description: Bio Blurb listing the awards won by the artist
    GetApiArtistIdIdResponse:
      type: object
      properties:
        results:
          type: array
          description: Array of objects
        offset:
          type: number
          description: Offset number
        limit:
          type: number
          description: Limit number
        total:
          type: number
          description: Total number
    GetApiApiidResponse:
      type: object
      properties:
        X-Rate-Limit-Remaining:
          type: integer
        X-Rate-Limit-Limit:
          type: integer
        X-Rate-Limit-Retry-After:
          type: integer
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Api