{
  "openapi": "3.0.1",
  "info": {
    "title": "Daikokuya Japan Buyback — What a Shop Actually Paid",
    "description": "Type a reference like 126610LN and see what Daikokuya in Japan actually paid for it, from six years of dated buyback records. You get the typical amount and range in yen, how many it bought, the year-by-year trend, and the price it offers today. $0.02 per model, no results = no charge. Unofficial.",
    "version": "0.1",
    "x-build-id": "V79yU3JCExoT1VkNk"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/jpmarketdata~daikokuya-japan-brand-buyback-checker/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-jpmarketdata-daikokuya-japan-brand-buyback-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~daikokuya-japan-brand-buyback-checker/runs": {
      "post": {
        "operationId": "runs-sync-jpmarketdata-daikokuya-japan-brand-buyback-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~daikokuya-japan-brand-buyback-checker/run-sync": {
      "post": {
        "operationId": "run-sync-jpmarketdata-daikokuya-japan-brand-buyback-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": [
          "model"
        ],
        "properties": {
          "model": {
            "title": "Model or reference number",
            "type": "string",
            "description": "What to look for in Daikokuya's buyback records: a reference number as the shop prints it, such as `126610LN` (Rolex), `M41894` (Louis Vuitton) or `AS5631` (Chanel). A brand name in Japanese (`ロレックス`, `エルメス`) also works and returns that brand's whole recent intake instead of one model. Everything in the run is measured over the records this word finds, so a reference number gives you one model's history and a brand name gives you a recent sample. One run is one model and costs a flat $0.02; a word the shop has never bought is not charged.",
            "default": "126610LN"
          },
          "category": {
            "title": "Kind of item",
            "enum": [
              "all",
              "watch",
              "bag",
              "wallet",
              "jewelry",
              "gem",
              "precious_metal",
              "liquor"
            ],
            "type": "string",
            "description": "Which part of the buyback archive to look in. `all` searches everything; picking one drops records that merely share the word, which lowers the count and can move the typical amount. Leave it on `all` when you search a reference number - a reference is already specific, and a wrong kind here would find nothing. It does not change what you are charged.",
            "default": "all"
          },
          "brandPage": {
            "title": "Brand price page (optional)",
            "type": "string",
            "description": "Leave empty and the brand is taken from the records themselves, which is right almost always. Fill it to force which of Daikokuya's brand price pages is read for the amount it advertises today - use the name in the page address, for example `rolex`, `vuitton`, `hermes`, `chanel`, `omega`, or a category page such as `bag` or `purse`. A name that is not one of the 37 brand pages or 9 category pages is ignored with a warning rather than failing the run. It does not change what you are charged.",
            "default": ""
          },
          "maxRecords": {
            "title": "Buyback records to read",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "How many dated purchases the amounts and the year-by-year table are measured over, newest first, in a single request. `recordsComplete` says `true` when that reached the end of the archive for this word and `false` when there is more behind it - and short changes the answer: a reference number usually finishes well inside 200 (126610LN has 256 records covering 2020 to 2026), while a bare brand name has thousands and will always be a recent sample. It also caps the rows charged at $0.002 each when the individual rows below are on.",
            "default": 200
          },
          "includeRecords": {
            "title": "Also list the individual records",
            "type": "boolean",
            "description": "Off by default: a run costs a flat $0.02 for the summary. Turn it on to also get one row per dated purchase (day bought, brand, model name, reference, amount paid in yen) and one row per line of that brand's advertised price page (reference, amounts by condition, list price and buyback rate where the brand publishes them), at +$0.002 per row. The rows are the ones already read for the summary, so this adds rows, not waiting - at most the record limit above plus the brand page's own lines, which ran from 32 (Rolex) to 717 (Hermes) when measured. Runs stop at the run option Maximum cost per run, $3.00 unless you raise it.",
            "default": false
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}