{
  "openapi": "3.0.1",
  "info": {
    "title": "Yahoo! Auctions Japan Sold Prices Scraper (ヤフオク落札相場)",
    "description": "Yahoo Auctions Japan scraper for sold prices (落札相場): closed-auction search with title, sold price JPY, bid count, end time, condition and category — English schema for resale comps and price research. Item facts only, no seller data. Unofficial; not affiliated with LY Corporation.",
    "version": "0.1",
    "x-build-id": "2GBsUkd0N2HegUezL"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/jpopendata~japan-yahoo-auction-sold/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-jpopendata-japan-yahoo-auction-sold",
        "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/jpopendata~japan-yahoo-auction-sold/runs": {
      "post": {
        "operationId": "runs-sync-jpopendata-japan-yahoo-auction-sold",
        "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/jpopendata~japan-yahoo-auction-sold/run-sync": {
      "post": {
        "operationId": "run-sync-jpopendata-japan-yahoo-auction-sold",
        "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",
        "properties": {
          "keyword": {
            "title": "Keyword",
            "type": "string",
            "description": "Search keyword for sold (closed) items, e.g. \"ポケモンカード\", \"Nikon F3\", \"ガンプラ\". Japanese keywords match best. Default \"フィギュア\" (figures) so a run with no input succeeds; an empty keyword falls back to it with a warning. For several keywords in one run use Keywords below (if you fill Keywords or Search URLs and leave this at the pre-filled \"フィギュア\", it is skipped).",
            "default": "フィギュア"
          },
          "keywords": {
            "title": "Keywords (several per run, optional)",
            "type": "array",
            "description": "Optional. Several keywords in one run, one per line, e.g. \"ポケモンカード\", \"Nikon F3\". Each keyword is searched separately, Max records applies per keyword, and every record then carries a keyword field (and a searchUrl field, null for keywords). Up to 100 keywords + URLs per run.",
            "items": {
              "type": "string"
            }
          },
          "searchUrls": {
            "title": "Search URLs (optional)",
            "type": "array",
            "description": "Optional. Paste Yahoo! Auctions search URLs, one per line — a sold-items search (https://auctions.yahoo.co.jp/closedsearch/closedsearch?p=...), a current-listings search or a category page also work (their keyword and category are used to search sold items). The keyword and category are kept; a price range (aucminprice/aucmaxprice/min/max) and the condition (istatus) are applied after fetching. Every other parameter — including those robots.txt disallows on the sold-items search (aucminprice, aucmaxprice, istatus, select, n, ...) — is never sent; the run log lists what was dropped. Records from a URL carry it in the searchUrl field.",
            "items": {
              "type": "string"
            }
          },
          "category": {
            "title": "Category id (auccat)",
            "type": "string",
            "description": "Optional. Numeric Yahoo Auctions category id to narrow the search (the auccat value in auctions.yahoo.co.jp category URLs — the URL itself is accepted too), e.g. 2084241343 = ポケモンカードゲーム. Leave empty to search all categories. Category NAMES are not accepted — put them in keyword."
          },
          "priceMin": {
            "title": "Min sold price (JPY)",
            "minimum": 0,
            "type": "integer",
            "description": "Optional. Lower bound on the sold price in JPY (e.g. 1000). Applied client-side after fetching (the equivalent URL parameter is disallowed by the site's robots.txt), so tight ranges may need a higher request budget. Leave empty for no minimum."
          },
          "priceMax": {
            "title": "Max sold price (JPY)",
            "minimum": 0,
            "type": "integer",
            "description": "Optional. Upper bound on the sold price in JPY (e.g. 50000). Applied client-side after fetching. Leave empty for no maximum."
          },
          "condition": {
            "title": "Item condition",
            "enum": [
              "any",
              "new",
              "used"
            ],
            "type": "string",
            "description": "Optional, default any. Filter by item condition (new = 未使用, used = 中古). Applied client-side after fetching.",
            "default": "any"
          },
          "sortBy": {
            "title": "Sort results by",
            "enum": [
              "endTime",
              "price"
            ],
            "type": "string",
            "description": "Optional, default endTime. endTime = most recently ended first (the source's native order). price = highest sold price first. Sorting is applied client-side to the collected records.",
            "default": "endTime"
          },
          "currencyConversion": {
            "title": "Add USD / EUR prices",
            "enum": [
              "none",
              "USD",
              "EUR",
              "USD_EUR"
            ],
            "type": "string",
            "description": "Optional, default none. Adds soldPriceUsd and/or soldPriceEur (rounded to cents) plus fxRateDate to every record, converted from soldPriceJpy at the European Central Bank's daily euro reference rates (fetched once per run, free public source). These are reference rates, not a bank's or marketplace's rate. If the rates cannot be fetched, the run still succeeds and the records come without these fields (a warning says why).",
            "default": "none"
          },
          "maxItems": {
            "title": "Max records",
            "minimum": 1,
            "maximum": 2000,
            "type": "integer",
            "description": "Optional, default 10. Stop after this many dataset records (1..2000) — per keyword / URL when Keywords or Search URLs are used. One request = one 50-item result page, so 500 records need maxApiRequests >= 10 (more with client-side filters).",
            "default": 10
          },
          "maxApiRequests": {
            "title": "Max upstream requests",
            "minimum": 1,
            "maximum": 200,
            "type": "integer",
            "description": "Optional, default 10. Hard budget of HTTP requests to auctions.yahoo.co.jp for this run (1..200; one request = one 50-item result page), shared fairly between keywords / URLs. Requests are strictly serial with >= 1.2 s spacing. When the budget runs out the run still SUCCEEDS with the records collected so far and complete=false in RUN_SUMMARY (not an error).",
            "default": 10
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Optional. Apify proxy settings. Default: no proxy (direct connection works). Never used for rotation/evasion — one client identity per run."
          }
        }
      },
      "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}