{
  "openapi": "3.0.1",
  "info": {
    "title": "Yahoo Auctions Japan Scraper - Sold Prices & Live Listings",
    "description": "Scrape Yahoo! Auctions Japan (ヤフオク) without login: final sold prices of ended auctions (sold comps), live listings and similar listings from a Yahoo Auctions listing or photo, with bids, condition, category, filters and optional full item pages. No seller personal data. US$ 1 per 1,000.",
    "version": "0.1",
    "x-build-id": "F9V2uO0QPdt6MesoM"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapewise~yahoo-auctions-japan-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapewise-yahoo-auctions-japan-scraper",
        "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/scrapewise~yahoo-auctions-japan-scraper/runs": {
      "post": {
        "operationId": "runs-sync-scrapewise-yahoo-auctions-japan-scraper",
        "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/scrapewise~yahoo-auctions-japan-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-scrapewise-yahoo-auctions-japan-scraper",
        "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": {
          "searchTerms": {
            "title": "Search terms",
            "type": "array",
            "description": "Keywords, one per line, in Japanese or English (for example nintendo switch, ポケモンカード, seiko 5). Each term runs one Yahoo! Auctions search and returns up to 'Max results per search' listings with price, bids, end time, condition, seller type and photo. Every row keeps its term. Leave empty and use links below, or leave both empty to run the example 'nintendo switch'. Also accepts 'keywords', 'queries', 'search' or 'query'.",
            "items": {
              "type": "string"
            }
          },
          "listingStatus": {
            "title": "Sold or live listings",
            "enum": [
              "sold",
              "active",
              "both"
            ],
            "type": "string",
            "description": "Sold (default) reads Yahoo! Auctions' ended-auction search: recently ended auctions with the final price and number of bids, the source for real market prices. Live returns auctions and fixed-price listings open now, with the current price, buy-now price and end time. Both runs one sold search and one live search per term, each row marked with its status. Also applies to similar listings: sold returns ended look-alikes with their final price, live the open ones.",
            "default": "sold"
          },
          "startUrls": {
            "title": "Yahoo! Auctions links",
            "type": "array",
            "description": "Yahoo! Auctions links, one per line: search links (https://auctions.yahoo.co.jp/search/search?p=... or /closedsearch/closedsearch?p=...), category links (/category/list/2084041921/) or item links (https://auctions.yahoo.co.jp/jp/auction/x1234567890). Search links keep their own filters. Item links always return the full item page. Also accepts 'urls' or 'itemUrls'.",
            "items": {
              "type": "string"
            }
          },
          "similarToItems": {
            "title": "Find similar listings (Yahoo! Auctions listing or photo)",
            "type": "array",
            "description": "Yahoo! Auctions listing links or auction ids (https://auctions.yahoo.co.jp/jp/auction/x1234567890 or x1234567890), one per line. The Actor takes the listing's main photo and returns the listings whose photos look most alike (the same model or product first), sold or live as set in 'Sold or live listings'. The listing itself is left out. Also accepts 'similarToItemIds'.",
            "items": {
              "type": "string"
            }
          },
          "imageUrls": {
            "title": "Yahoo! Auctions photo links",
            "type": "array",
            "description": "Links of photos hosted by Yahoo! Auctions (auctions.c.yimg.jp or the auc-pctr.c.yimg.jp thumbnail links from a search), one per line, for the same similar-listings search. Yahoo only matches photos it already hosts: a photo from any other site returns a free UNSUPPORTED_IMAGE row. Also accepts 'imageUrl' or 'images'.",
            "items": {
              "type": "string"
            }
          },
          "maxResultsPerImage": {
            "title": "Max similar listings per listing or photo",
            "minimum": 0,
            "maximum": 3000,
            "type": "integer",
            "description": "How many similar listings to take for each listing or photo above, most similar first (Yahoo serves 96 per page). Empty means 30; 0 means as many as Yahoo returns, up to 3,000. Price, condition, category, exclude-word and store filters apply. Also accepts 'maxItemsPerImage'."
          },
          "maxResultsPerSearch": {
            "title": "Max results per search",
            "minimum": 1,
            "maximum": 15000,
            "type": "integer",
            "description": "How many listings to take from each search, in the chosen order (1 to 15,000). Yahoo! Auctions serves 100 per page and at most 15,000 per search. Empty means 100, one page. You pay per listing delivered. Also accepts 'maxItemsPerSearch'."
          },
          "maxItems": {
            "title": "Max listings in total",
            "minimum": 0,
            "type": "integer",
            "description": "Hard cap on charged listings for the whole run, across all searches and links together (for example 500). Empty or 0 means no run cap besides the per-search limit. Also accepts 'maxResults' or 'limit'."
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "default",
              "newest",
              "endingSoon",
              "priceLow",
              "priceHigh"
            ],
            "type": "string",
            "description": "Order of the results: Default (for sold, most recently ended first), Newest, Ending soon (live only), Price low to high or Price high to low. With a per-search limit it decides which listings you get. Applies to search terms; search links keep their own order unless you set one here."
          },
          "minPrice": {
            "title": "Min price (JPY)",
            "minimum": 0,
            "type": "integer",
            "description": "Only listings at or above this price in Japanese yen (for example 5000): the final price for sold listings, the current price for live ones. Leave empty for no minimum."
          },
          "maxPrice": {
            "title": "Max price (JPY)",
            "minimum": 0,
            "type": "integer",
            "description": "Only listings at or below this price in Japanese yen (for example 30000). Must be higher than the minimum price. Leave empty for no maximum."
          },
          "condition": {
            "title": "Condition",
            "enum": [
              "any",
              "new",
              "used"
            ],
            "type": "string",
            "description": "Yahoo! Auctions' own condition filter: Any (also when empty), New or Used."
          },
          "categoryId": {
            "title": "Category ID",
            "type": "string",
            "description": "The number in a Yahoo! Auctions category link, for example 2084041921 (trading cards) from auctions.yahoo.co.jp/category/list/2084041921/. Limits the search terms to that category. Empty means all categories."
          },
          "excludeKeywords": {
            "title": "Exclude listings whose title contains",
            "type": "array",
            "description": "Words, one per line (for example ジャンク, junk, 部品取り). Listings with any of them in the title are skipped and not charged. Useful to keep broken items and parts out of price research.",
            "items": {
              "type": "string"
            }
          },
          "storeSellersOnly": {
            "title": "Store sellers only",
            "type": "boolean",
            "description": "Keeps only listings from registered Yahoo! stores, not individual sellers. Skipped listings are not charged. Off by default."
          },
          "includeDetails": {
            "title": "Include full item page",
            "type": "boolean",
            "description": "Opens each listing's page and adds the description, all photos, exact condition, category and brand path, item specs, shipping methods and seller rating count. Charged as a 'Full item page added' event (US$ 0.667 per 1,000 listings), only when the page is still online; ended flea-market items are often removed and keep their search data for free. Off by default."
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Apify datacenter proxy is the default and works for Yahoo! Auctions. Refused requests are retried on their own. Keep the default.",
            "default": {
              "useApifyProxy": 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
                  },
                  "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}