{ "openapi": "3.0.1", "info": { "title": "Oricon Japan Charts — Rank, Artist and Copies Sold", "description": "Pick an Oricon chart — weekly singles, albums, comics, books or streaming — and get its newest edition. Every entry comes with its position, title, artist or author, release date and estimated copies sold, plus typical and total sales that week. $0.02 per chart, no results = no charge. Unofficial.", "version": "0.1", "x-build-id": "RMwKNjnZnUIJbj4Ic" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jpmarketdata~oricon-japan-chart-checker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jpmarketdata-oricon-japan-chart-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~oricon-japan-chart-checker/runs": { "post": { "operationId": "runs-sync-jpmarketdata-oricon-japan-chart-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~oricon-japan-chart-checker/run-sync": { "post": { "operationId": "run-sync-jpmarketdata-oricon-japan-chart-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": [ "charts" ], "properties": { "charts": { "title": "Chart codes", "type": "array", "description": "Which Oricon charts to read, by their code: `js` singles, `ja` albums, `st` streaming, `obc` comics, `ob` books, `dg` DVD. Each chart returns one summary row and is charged $0.02, and a chart Oricon does not publish is not charged. Up to 10 charts per run; a run also stops after 240 seconds, and charts it never read are never charged. Turn on the chart list below to get every code.", "default": [ "js" ], "items": { "type": "string" } }, "period": { "title": "Chart period", "enum": [ "weekly", "daily", "monthly", "yearly" ], "type": "string", "description": "Which edition of each chart to read. Weekly is the one to use: it is the edition that carries the estimated copies sold, it covers seven days, and almost every chart publishes it. Daily prints the figure for the top few places only, monthly prints it for all of them, and yearly prints none at all. A chart that has no edition for the period you pick comes back as `not_found` and is not charged.", "default": "weekly" }, "maxRanks": { "title": "Places to read per chart", "minimum": 1, "maximum": 100, "type": "integer", "description": "How far down each chart to read, in places. Oricon prints 10 places per page, so this is rounded up to whole pages and never goes past the end of the chart: weekly music stops at 50, comics and daily music at 30, yearly at 100. Reading further makes the run longer and the typical and total figures cover more places. It does not change the $0.02, but it does change how many entry rows you get.", "default": 10 }, "includeIndividualEntries": { "title": "Include every entry", "type": "boolean", "description": "Off by default: a run costs a flat $0.02 per chart summary. Turn it on to also get one row per place read — position, up/down/new, title, artist or author, release date, estimated copies sold, best position so far, label, publisher, cover price, JAN or ISBN and the link to the entry on Oricon — at +$0.002 per row.", "default": false }, "listCharts": { "title": "List the available charts", "type": "boolean", "description": "Off by default. Turn it on and the run returns the chart list instead of any summary: one row per chart and period Oricon offers right now, with its code, its Japanese name and the date of its newest edition. Nothing is charged for this. Use it once to find the codes you want, then turn it back off.", "default": false }, "convertToUsd": { "title": "Convert prices to US$", "type": "boolean", "description": "Adds US$ figures next to the yen cover prices using today's exchange rate (open.er-api.com). Only the book and comic charts print a cover price, so on a music chart there is nothing to convert and no rate is looked up. A failed rate lookup never fails the run — you simply get the yen figures 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 } } } } } } } } } }