The社史 - API for AI Agents

openapi: 3.1.0
info:
  title: The社史 Public Data API
  version: "2.0"
servers:
  - url: https://the-shashi.com
paths:
  /companies.json:
    get:
      summary: 公開中の全社一覧
      responses:
        "200":
          description: 証券コード・企業名・業種・創業年・直近業績・企業史要約などを含む一覧
          content:
            application/json:
              schema:
                type: object
                properties:
                  contents:
                    type: array
                    items:
                      type: object
                      properties:
                        updated: { type: string, format: date }
                        company:
                          type: object
                          properties:
                            stock_code: { type: string, example: "1332" }
                            name: { type: string }
                            industry: { type: string, nullable: true }
                            historical_summary: { type: string }
                          additionalProperties: true
                      additionalProperties: true
                additionalProperties: true

  /api/{stock_code}/meta.json:
    get:
      summary: 企業の基礎メタ情報
      parameters:
        - in: path
          name: stock_code
          required: true
          schema: { type: string, example: "7203" }
      responses:
        "200":
          description: 証券コード・企業名・業種・企業色・創業情報・上場情報
          content:
            application/json:
              schema:
                type: object
                properties:
                  stock_code: { type: string }
                  company_name: { type: string }
                  company_color: { type: string }
                  industry: { type: string }
                  published: { type: string, format: date }
                  updated: { type: string, format: date }
                  found: { type: object, additionalProperties: true }
                  listing: { type: object, additionalProperties: true }
                  old_name: { type: string, nullable: true }
                additionalProperties: true

  /api/{stock_code}/summary.json:
    get:
      summary: 企業史の要約と筆者所感
      parameters:
        - in: path
          name: stock_code
          required: true
          schema: { type: string, example: "7203" }
      responses:
        "200":
          description: history.summary と筆者所感（公開フラグ付き）
          content:
            application/json:
              schema:
                type: object
                properties:
                  summary: { type: string }
                  author_note: { type: array, items: { type: string } }
                  published: { type: boolean }
                additionalProperties: true

  /api/{stock_code}/history.json:
    get:
      summary: 章立てされた歴史概略本体
      parameters:
        - in: path
          name: stock_code
          required: true
          schema: { type: string, example: "7203" }
      responses:
        "200":
          description: 時代区分ごとに章立てされたセクションと要約
          content:
            application/json:
              schema:
                type: object
                properties:
                  title: { type: string }
                  sections:
                    type: array
                    items: { type: object, additionalProperties: true }
                  summary: { type: object, additionalProperties: true }
                additionalProperties: true

  /api/{stock_code}/current.json:
    get:
      summary: 直近の動向と展望
      parameters:
        - in: path
          name: stock_code
          required: true
          schema: { type: string, example: "7203" }
      responses:
        "200":
          description: history から分離した「直近の動向と展望」サブセクション
          content:
            application/json:
              schema:
                type: object
                properties:
                  title: { type: string }
                  subsections:
                    type: array
                    items: { type: object, additionalProperties: true }
                additionalProperties: true

  /api/{stock_code}/decisions.json:
    get:
      summary: 経営判断・意思決定の時系列カード
      parameters:
        - in: path
          name: stock_code
          required: true
          schema: { type: string, example: "7203" }
      responses:
        "200":
          description: 経営判断・意思決定オブジェクトの配列
          content:
            application/json:
              schema:
                type: object
                properties:
                  decisions:
                    type: array
                    items: { type: object, additionalProperties: true }
                additionalProperties: true

  /api/{stock_code}/timeline.json:
    get:
      summary: 出来事の年表
      parameters:
        - in: path
          name: stock_code
          required: true
          schema: { type: string, example: "7203" }
      responses:
        "200":
          description: 年月・区分・地域・重要度・出来事・歴史的意義などを含む年表エントリ
          content:
            application/json:
              schema:
                type: object
                properties:
                  timeline:
                    type: array
                    items: { type: object, additionalProperties: true }
                additionalProperties: true

  /api/{stock_code}/references.json:
    get:
      summary: 参照元一覧・数字の根拠・引用
      parameters:
        - in: path
          name: stock_code
          required: true
          schema: { type: string, example: "7203" }
      responses:
        "200":
          description: 出典・数字の根拠・発言/評価の引用
          content:
            application/json:
              schema:
                type: object
                properties:
                  references: { type: array, items: { type: object, additionalProperties: true } }
                  number_basis: { type: array, items: { type: object, additionalProperties: true } }
                  quotes: { type: array, items: { type: object, additionalProperties: true } }
                additionalProperties: true

  /api/{stock_code}/ceo.json:
    get:
      summary: 歴代経営者と関連解説
      parameters:
        - in: path
          name: stock_code
          required: true
          schema: { type: string, example: "7203" }
      responses:
        "200":
          description: 経営者一覧と運営者によるコメンタリー
          content:
            application/json:
              schema:
                type: object
                properties:
                  commentary: { type: string }
                  ceos: { type: array, items: { type: object, additionalProperties: true } }
                additionalProperties: true

  /api/{stock_code}/executive.json:
    get:
      summary: 役員一覧・経歴・専門領域
      parameters:
        - in: path
          name: stock_code
          required: true
          schema: { type: string, example: "7203" }
      responses:
        "200":
          description: 役員一覧、経歴、専門領域、運営者コメンタリー
          content:
            application/json:
              schema:
                type: object
                properties:
                  commentary: { type: string }
                  executives: { type: array, items: { type: object, additionalProperties: true } }
                  careers: { type: array, items: { type: object, additionalProperties: true } }
                  specialties: { type: array, items: { type: object, additionalProperties: true } }
                additionalProperties: true

  /api/{stock_code}/shareholder.json:
    get:
      summary: 大株主・カテゴリ別保有比率の推移
      parameters:
        - in: path
          name: stock_code
          required: true
          schema: { type: string, example: "7203" }
      responses:
        "200":
          description: 大株主の年次推移、カテゴリ別比率、長期保有
          content:
            application/json:
              schema:
                type: object
                properties:
                  commentary: { type: string }
                  shareholders: { type: array, items: { type: object, additionalProperties: true } }
                  categories: { type: array, items: { type: object, additionalProperties: true } }
                  long_term: { type: array, items: { type: object, additionalProperties: true } }
                additionalProperties: true

  /api/{stock_code}/data.json:
    get:
      summary: 長期業績・財務データ
      parameters:
        - in: path
          name: stock_code
          required: true
          schema: { type: string, example: "7203" }
      responses:
        "200":
          description: PL/CF/BS、PL/BS/CF 詳細、セグメント、地域別、従業員などの年次配列
          content:
            application/json:
              schema:
                type: object
                properties:
                  commentary: { type: string }
                  pl: { type: array, items: { type: object, additionalProperties: true } }
                  cf: { type: array, items: { type: object, additionalProperties: true } }
                  bs: { type: array, items: { type: object, additionalProperties: true } }
                  pl_detail: { type: array, items: { type: object, additionalProperties: true } }
                  bs_detail: { type: array, items: { type: object, additionalProperties: true } }
                  cf_detail: { type: array, items: { type: object, additionalProperties: true } }
                  others: { type: array, items: { type: object, additionalProperties: true } }
                  segment: { type: array, items: { type: object, additionalProperties: true } }
                  region: { type: array, items: { type: object, additionalProperties: true } }
                  employee: { type: array, items: { type: object, additionalProperties: true } }
                additionalProperties: true