{
  "openapi": "3.0.1",
  "info": {
    "title": "Tower Records Japan Prices — CD, Vinyl, In Stock",
    "description": "Type an artist, album or catalog number and get what Tower Records Japan charges for it today. Returns the typical price and lowest–highest in yen, how many were found, the CD / vinyl / cassette mix, and how many are in stock or out of print. $0.02 per keyword, no results = no charge. Unofficial.",
    "version": "0.1",
    "x-build-id": "7tULlcZ2g0gY2ZhcX"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/jpmarketdata~tower-records-japan-price-checker/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-jpmarketdata-tower-records-japan-price-checker",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/jpmarketdata~tower-records-japan-price-checker/runs": {
      "post": {
        "operationId": "runs-sync-jpmarketdata-tower-records-japan-price-checker",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/jpmarketdata~tower-records-japan-price-checker/run-sync": {
      "post": {
        "operationId": "run-sync-jpmarketdata-tower-records-japan-price-checker",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "required": [
          "keywords"
        ],
        "properties": {
          "keywords": {
            "title": "Artist, album or catalog number",
            "minItems": 1,
            "maxItems": 10,
            "type": "array",
            "description": "What to look up at Tower Records Japan: an artist, an album title or the catalog number on the disc, in Japanese or romaji (measured 2026-09-09: `山下達郎` 1,248 releases, `YOASOBI` 386). Each word gets its own summary row and is charged $0.02; a word that finds nothing is not charged. Up to 10 per run, and a run stops at the $3.00 Maximum cost per run — raise it in the run options, or split the run.",
            "default": [
              "山下達郎"
            ],
            "items": {
              "type": "string"
            }
          },
          "sortBy": {
            "title": "Order to read the shop in",
            "enum": [
              "price_asc",
              "price_desc",
              "newest",
              "oldest",
              "bestselling",
              "recommended"
            ],
            "type": "string",
            "description": "Which order the shop is read in. `price_asc` (the default) is the only order whose typical price and lowest–highest range cover every matching release, because the cheapest-first order is read at exact positions. Any other order measures those on the listings read, and each row says which in `priceBasis`. The number found and the format, import, era and genre breakdowns are exact either way.",
            "default": "price_asc"
          },
          "formats": {
            "title": "Formats to keep (optional)",
            "type": "array",
            "description": "Narrow the search to certain formats using Tower's own codes: `121` CD, `114` LP, `111` 7-inch, `115` 12-inch, `118` 10-inch, `112` cassette, `131` CD single, `120` SHM-CD, `221` DVD, `225` Blu-ray, `311` book, `331` magazine. Left empty it keeps everything the word matches — for an artist that often includes print titles that merely feature them. Every code in `formatMix` works here.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "importType": {
            "title": "Japanese pressing or import",
            "enum": [
              "any",
              "domestic",
              "import",
              "import-domestic-spec"
            ],
            "type": "string",
            "description": "Keep only Japanese pressings, only imports, or only imports sold in Japanese packaging. `any` (the default) keeps all three and still reports the split, so pick one here only when you want the price numbers themselves measured on that group alone.",
            "default": "any"
          },
          "exactMatch": {
            "title": "Match the whole word only",
            "type": "boolean",
            "description": "Off by default, which is the shop's own broad match. Turn it on to keep only releases whose text matches the word exactly — it cuts the count sharply (measured 2026-09-09: `山下達郎` went from 1,248 to 229), so use it when a common word is pulling in releases you did not mean.",
            "default": false
          },
          "maxItemsPerKeyword": {
            "title": "Listings read per keyword",
            "minimum": 10,
            "maximum": 500,
            "type": "integer",
            "description": "How many of the cheapest listings are read for each word. It sets how many rows you can get back (with the toggle below, at +$0.002 per row) and how many listings the stock, out-of-print, discount and record-label counts are measured over. It does not change the number found or the price, format, import and era breakdowns. At 500 rows a word, three words reach the $3.00 Maximum cost per run.",
            "default": 100
          },
          "includeIndividualItems": {
            "title": "Include individual listings",
            "type": "boolean",
            "description": "Off by default: a run costs a flat $0.02 per keyword summary. Turn it on to also get one row per listing — title, artist, format, price in yen, discount, points, stock state, Japanese pressing or import, release date, catalog number, record label and the link — at +$0.002 per row. No image, description or review text is ever returned.",
            "default": false
          },
          "convertToUsd": {
            "title": "Convert prices to USD",
            "type": "boolean",
            "description": "Adds USD figures next to the yen ones at the current exchange rate (open.er-api.com). A failed rate lookup never fails the run — the yen numbers come back on their own.",
            "default": true
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}