{
  "openapi": "3.0.1",
  "info": {
    "title": "Japan Phone Buyback Prices - iPhone, Android, Switch 買取",
    "description": "Buyback (買取) prices of iPhones, Android phones, iPads and game consoles from 3 Japanese buyback shops (買取商店, 携帯空間, モバイル一番) in one table: model, capacity, colour, carrier, new/opened/used price, JAN, update date and a cross-shop match key. Unofficial; not affiliated with the shops.",
    "version": "0.1",
    "x-build-id": "HbTO49kgP1aichuCd"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/jpopendata~japan-phone-buyback-prices/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-jpopendata-japan-phone-buyback-prices",
        "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-phone-buyback-prices/runs": {
      "post": {
        "operationId": "runs-sync-jpopendata-japan-phone-buyback-prices",
        "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-phone-buyback-prices/run-sync": {
      "post": {
        "operationId": "run-sync-jpopendata-japan-phone-buyback-prices",
        "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": "Model names (keywords)",
            "type": "array",
            "description": "Model names to look up, one per line, as the shops write them (Latin letters): \"iPhone 17 Pro\", \"iPhone 16 128GB\", \"Pixel 10\", \"Galaxy S25\", \"Nintendo Switch 2\", \"AirPods Pro 第3世代\". A row is kept only when its listing name contains every word of the keyword as a whole word (\"iPhone 17\" also matches \"iPhone 17 Pro\" but not \"iPhone 17e\"; add a capacity such as \"256GB\" to narrow it). If keywords, categories and startUrls are all empty, the Quick start keyword is used.",
            "default": [
              "iPhone 17 Pro"
            ],
            "items": {
              "type": "string"
            }
          },
          "categories": {
            "title": "Browse whole categories (optional)",
            "type": "array",
            "description": "Optional. Read every listing of a category at every selected shop: \"iphone\" (all iPhones the shops buy) and/or \"ipad\". Good for a daily full price list. Takes more requests and time than keywords (モバイル一番 reads one list per model, about 40 for iPhone). For Android phones, consoles and others, use keywords.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "shops": {
            "title": "Shops",
            "type": "array",
            "description": "Which shops to read, one per line: kaitorishouten (買取商店), keitaispace (携帯空間), mobileichiban (モバイル一番). Japanese names and the site domains work too. Default: all three. イオシス, じゃんぱら and GEO are not supported (their firewall or terms do not allow this Actor's automated access).",
            "default": [
              "kaitorishouten",
              "keitaispace",
              "mobileichiban"
            ],
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Shop list URLs (optional)",
            "type": "array",
            "description": "Optional. Paste shop list URLs, one per line: 買取商店 https://www.kaitorishouten-co.jp/products/list?category_id=17, /category/1/747 or /products/detail/27097; 携帯空間 https://www.keitaispace.co.jp/product/?ca=23 or /product/?kw=... Every listing of the page is kept (no keyword filter). モバイル一番 has no list URLs — use keywords.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "makers": {
            "title": "Makers (optional)",
            "type": "array",
            "description": "Optional. Keep only these makers, as the output's maker field writes them: Apple, Google, Samsung, Sony, Sharp, FCNT, OPPO, Xiaomi, Motorola, ASUS, Nintendo, Microsoft, Valve, Huawei, ZTE, Kyocera, Garmin, Meta, Nothing, Lenovo (Japanese names such as アップル or 任天堂 work too). Empty = all makers.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "conditions": {
            "title": "Conditions (optional)",
            "type": "array",
            "description": "Optional. Keep only \"new\" (新品 / 未使用 / 未開封, including opened-but-unused rows where a shop prices them) and/or \"used\" (中古). Empty = both.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "excludeWords": {
            "title": "Exclude words (optional)",
            "type": "array",
            "description": "Optional. Drop listings whose name contains any of these words (whole words), e.g. \"Max\" to keep \"iPhone 17 Pro\" but not \"iPhone 17 Pro Max\", or \"中古\".",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "Max records",
            "type": "integer",
            "description": "Maximum records stored for the whole run, all shops together (1..100000; values outside are clamped). One model name such as \"iPhone 17 Pro\" gives about 100 rows across the three shops (each colour / condition is a row). Each stored record is charged.",
            "default": 500
          },
          "maxPagesPerShop": {
            "title": "Max list pages per query",
            "type": "integer",
            "description": "Upper bound of list pages read per keyword / category at one shop (1..50). 携帯空間 shows 12 listings per page, 買取商店 100. When a query has more pages than this, the run says so (complete=false). モバイル一番 (one list per model) is not affected.",
            "default": 5
          },
          "proxyConfiguration": {
            "title": "Proxy for 買取商店 and 携帯空間",
            "type": "object",
            "description": "Optional proxy for 買取商店 and 携帯空間. Default: no proxy — both answer Apify's servers directly (verified 2026-10-13). If you set one, one sticky session (one IP) is kept per shop for the whole run, never rotation; only if a shop's very first request is refused is it retried once on a fresh session.",
            "default": {
              "useApifyProxy": false
            }
          },
          "residentialProxyConfiguration": {
            "title": "Proxy for モバイル一番",
            "type": "object",
            "description": "Proxy for モバイル一番, which refuses Apify datacenter IPs (dropped connections, verified 2026-10-13; it answers through a Japanese residential IP). Default: Apify RESIDENTIAL proxies, country JP — billed by Apify as proxy traffic (a list page is about 200 KB). One sticky session for the whole run, never rotation; only a refused first request is retried once on a fresh session. Turning it off makes モバイル一番 fail on Apify.",
            "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
                  },
                  "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}