Music Story Music Story API

openapi: 3.2.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
security:
- bearer: []
tags:
- name: Music Story API
paths:
  /:
    get:
      operationId: get
      tags:
      - Music Story 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/{apiid}:
    get:
      operationId: get_api_apiid
      tags:
      - Music Story 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:
    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