{ "openapi": "3.0.1", "info": { "title": "Suruga-ya (駿河屋) – Used Hobby Item Price Scraper", "description": "Scrape used hobby-goods prices from Suruga-ya, Japan's big second-hand store for figures, anime merchandise, games, and collectibles. Get used and new prices, stock, category, and images as clean JSON. Great for resale sourcing and price research across Japanese collectibles. No code required.", "version": "0.0", "x-build-id": "jA5WO5ztqpExfhhZ9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datalab-jp~suruga-ya-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datalab-jp-suruga-ya-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/datalab-jp~suruga-ya-scraper/runs": { "post": { "operationId": "runs-sync-datalab-jp-suruga-ya-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/datalab-jp~suruga-ya-scraper/run-sync": { "post": { "operationId": "run-sync-datalab-jp-suruga-ya-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": { "searchKeyword": { "title": "Search keyword", "type": "string", "description": "Keyword to search on Suruga-ya, Japan's largest used hobby marketplace, e.g. 'ポケモン' (Pokemon) or 'ガンダム' (Gundam), 'ワンピース フィギュア' (One Piece figures). Both Japanese and romanized English keywords work, since many product titles are indexed in both scripts. If omitted, the Actor falls back to the default keyword 'ポケモン' shown below rather than failing. At least one of `searchKeyword` or `categoryId` must be set, or the run throws an error before scraping starts.", "default": "ポケモン" }, "categoryId": { "title": "Category ID (optional)", "type": "string", "description": "Suruga-ya category id used to narrow the search to one product type, such as figures, trading cards, or retro games (find the numeric id in a Suruga-ya category URL's `category` parameter). Example values look like '200' or '7'. Leave this empty to search across all categories using only `searchKeyword`. It can also be combined with `searchKeyword` to search a keyword within one category, or used alone to browse a whole category without a keyword." }, "inStockOnly": { "title": "In-stock items only", "type": "boolean", "description": "When enabled, skips sold-out (品切れ) listings and returns only items currently available to buy as used or new stock. For example, turn this on when sourcing items to purchase, or leave it off when you also want list-price (定価) data for out-of-stock items. If omitted, it defaults to `false`, meaning both in-stock and sold-out listings are returned. Stock status is determined by whether a used or new price is present on the listing.", "default": false }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of product listings to return across all paginated search result pages, for example 50 for a quick sample or 1000 for a broad market scan. Accepts whole numbers from 1 to 5000. If omitted, it defaults to 100. Each returned item is one billable result, so this field is the primary way to control run cost, and the Actor stops paginating once the limit or the last available page is reached.", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy settings used for every request to Suruga-ya. This Actor's WAF blocks Apify's datacenter proxy IPs and non-Japanese residential IPs outright, so a Japan-based residential proxy is required for reliable results. The default below (`RESIDENTIAL` group, country `JP`) is pre-configured for this reason and should not be changed to datacenter or non-JP settings. Residential proxy traffic costs more per GB than datacenter, so factor that into cost estimates for large runs.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "JP" } } } }, "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 } } } } } } } } } }