{
  "openapi": "3.0.1",
  "info": {
    "title": "Yahoo! Auctions Japan Scraper - Active Listings (ヤフオク)",
    "description": "Yahoo Auctions Japan scraper for active listings (ヤフオク出品中): keyword search with title, current and buy-it-now price in JPY, bids, end time, condition, category and shipping. English schema, robots.txt-compliant URLs. Item facts only, no seller data. Unofficial; not affiliated with LY Corporation.",
    "version": "0.1",
    "x-build-id": "FuDT38uuDbi5t4qbW"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/jpopendata~japan-yahoo-auctions/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-jpopendata-japan-yahoo-auctions",
        "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-auctions/runs": {
      "post": {
        "operationId": "runs-sync-jpopendata-japan-yahoo-auctions",
        "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-auctions/run-sync": {
      "post": {
        "operationId": "run-sync-jpopendata-japan-yahoo-auctions",
        "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": {
          "keywords": {
            "title": "Keywords",
            "type": "array",
            "description": "What to search for, one keyword per line, e.g. \"ポケモンカード\", \"Nikon F3\", \"ガンプラ\". Japanese keywords match best. Each keyword is searched separately and every record carries its keyword. Up to 100 keywords + URLs per run. If both this and Search URLs are empty, the Quick start keywords are used.",
            "default": [
              "ポケモンカード",
              "Nintendo Switch"
            ],
            "items": {
              "type": "string"
            }
          },
          "searchUrls": {
            "title": "Search URLs (optional)",
            "type": "array",
            "description": "Paste search result URLs from auctions.yahoo.co.jp, one per line: a keyword search (https://auctions.yahoo.co.jp/search/search?p=...), a category page (https://auctions.yahoo.co.jp/category/list/2084241343/) or a sold-items search (its keyword and category are used). The Actor keeps the keyword, category and price range, and the condition (applied after fetching). Parameters that the site's robots.txt disallows (sort s1/o1, page size n, istatus, is_postage_mode and others) are never sent; the run log lists every dropped parameter. Records from a URL carry it in the searchUrl field. When URLs are given and Keywords still holds the pre-filled Quick start list, only the URLs are searched.",
            "items": {
              "type": "string"
            }
          },
          "category": {
            "title": "Category id (auccat)",
            "type": "string",
            "description": "Optional. Numeric Yahoo! Auctions category id to narrow every KEYWORD search (the auccat value from auctions.yahoo.co.jp category URLs; the URL itself is accepted too), e.g. 2084241343 = ポケモンカードゲーム. Pasted Search URLs keep their own category. Leave empty for all categories. Category NAMES are not accepted — put them in Keywords.",
            "default": ""
          },
          "priceMin": {
            "title": "Min current price (JPY)",
            "minimum": 0,
            "type": "integer",
            "description": "Optional. Minimum CURRENT price in JPY (e.g. 1000). Sent to the site as its aucminprice filter and re-checked on every listing. Leave empty for no minimum."
          },
          "priceMax": {
            "title": "Max current price (JPY)",
            "minimum": 0,
            "type": "integer",
            "description": "Optional. Maximum CURRENT price in JPY (e.g. 50000). Sent to the site as its aucmaxprice filter and re-checked on every listing. Leave empty for no maximum."
          },
          "condition": {
            "title": "Condition",
            "type": "string",
            "description": "any (default), new or used. Japanese labels work too (新品, 未使用, 中古). new = the listing shows the 未使用 (unused) badge on the search result; used = it does not. Applied after fetching.",
            "default": "any"
          },
          "buyItNowOnly": {
            "title": "Buy-it-now only",
            "type": "boolean",
            "description": "Keep only listings that have a buy-it-now price (即決価格). Applied after fetching.",
            "default": false
          },
          "endingWithinHours": {
            "title": "Ending within (hours)",
            "type": "integer",
            "description": "Optional ending-soon filter: keep only listings whose auction ends within this many hours from now (1..720, e.g. 6 or 24). Leave empty for no filter. The site's end-time sort is disallowed by robots.txt, so listings are read in the site's default order and filtered after fetching — a short window on a broad keyword needs a larger request budget."
          },
          "maxItemsPerKeyword": {
            "title": "Max listings per keyword",
            "type": "integer",
            "description": "Listing records kept per keyword or URL (1..50000; values outside are clamped). One request returns one 50-listing result page, so 200 listings need about 4 requests per keyword (more with filters). The site shows at most 15,000 results per search; to go beyond that, also raise maxApiRequests so the search gets more than 300 requests — it is then split into price bands automatically.",
            "default": 10
          },
          "maxApiRequests": {
            "title": "Max upstream requests (whole run)",
            "type": "integer",
            "description": "Hard budget of requests to auctions.yahoo.co.jp for the whole run (1..1000; clamped), shared fairly between keywords and URLs. Requests are strictly serial with at least 1.2 s spacing (1000 requests take roughly 30 minutes). If the budget runs out the run still SUCCEEDS with the listings found so far and complete=false in the RUN_SUMMARY record of the key-value store.",
            "default": 20
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Optional. auctions.yahoo.co.jp answers Apify datacenter IPs directly, so no proxy is used by default. If you set one, the run keeps a single sticky session (one IP) — never rotation.",
            "default": {
              "useApifyProxy": 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
                  },
                  "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}