{
  "openapi": "3.0.1",
  "info": {
    "title": "Taobao & Tmall 淘宝 Price Monitor · Мониторинг цен Taobao",
    "description": "Watch Taobao and Tmall prices and stock between runs: price drops and rises in %, your own threshold, sold out, back in stock, new and removed variants. Следите за ценами и остатками Taobao и Tmall: рост и падение цены в %, свой порог, распродано, снова в наличии, новые и пропавшие варианты.",
    "version": "0.1",
    "x-build-id": "I4duwvo4TJeF7p2dK"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/theshark~taobao-price-monitor/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-theshark-taobao-price-monitor",
        "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/theshark~taobao-price-monitor/runs": {
      "post": {
        "operationId": "runs-sync-theshark-taobao-price-monitor",
        "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/theshark~taobao-price-monitor/run-sync": {
      "post": {
        "operationId": "run-sync-theshark-taobao-price-monitor",
        "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",
        "required": [
          "items"
        ],
        "properties": {
          "items": {
            "title": "Products · Товары",
            "type": "array",
            "description": "One product per line: a link (item.taobao.com, detail.tmall.com, detail.tmall.hk, m.intl.taobao.com, world.taobao.com with a number), a product ID, the text copied from the Taobao app's Share button, or a link from a buying agent (CNFans, Hoobuy, KakoBuy, Superbuy, CSSBuy and others). The same product given twice is checked once.<br><br>По товару на строку: ссылка (item.taobao.com, detail.tmall.com, detail.tmall.hk, m.intl.taobao.com, world.taobao.com с номером), номер товара, текст из кнопки «Поделиться» приложения Taobao или ссылка байера (CNFans, Hoobuy, KakoBuy, Superbuy, CSSBuy и другие). Один товар, данный дважды, проверяется один раз.",
            "items": {
              "type": "string"
            }
          },
          "only_changes": {
            "title": "Only changes · Только изменения",
            "type": "boolean",
            "description": "On: a product with no change since the previous check is not written to the dataset, but the check is paid. A product checked for the first time is always written. Off: every checked product gets a row.<br><br>Включено: товар без изменений с прошлой проверки в датасет не попадает, но проверка оплачивается. Товар, проверенный впервые, попадает всегда. Выключено: строка на каждый проверенный товар.",
            "default": true
          },
          "min_price_change": {
            "title": "Minimum price change, % · Порог изменения цены, %",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "A price change smaller than this, in percent to 0.1, is not a change. The next check is then compared with the same earlier price, so small steps add up: with 5, a price of 100, then 97, then 94 is a drop of 6 % from 100. 0: every price change counts. Stock and variant changes are marked as usual.<br><br>Изменение цены меньше этого, в процентах до 0,1, — не изменение. Следующая проверка тогда сравнивается с той же прежней ценой, поэтому мелкие шаги складываются: при 5 цена 100, потом 97, потом 94 — падение на 6 % от 100. 0 — считается любое изменение цены. Изменения остатка и вариантов отмечаются как обычно.",
            "default": 0
          },
          "currency": {
            "title": "Price also in · Цена ещё и в",
            "enum": [
              "CNY",
              "USD",
              "EUR",
              "RUB",
              "GBP",
              "PLN",
              "UAH",
              "KZT",
              "BRL",
              "CAD",
              "AUD"
            ],
            "type": "string",
            "description": "Besides the price in yuan (CNY), give it in this currency at today's exchange rate. Changes are always found on the yuan price, so switching the currency between runs does not make a change. Included in the price.<br><br>Кроме цены в юанях (CNY), дать её в этой валюте по курсу дня. Изменения ищутся всегда по цене в юанях, поэтому смена валюты между запусками изменением не считается. Входит в цену.",
            "default": "CNY"
          },
          "output_language": {
            "title": "Language of messages · Язык сообщений",
            "enum": [
              "en",
              "ru"
            ],
            "type": "string",
            "description": "Language of the run log and status messages. Product data stays as Taobao gives it.<br><br>Язык лога и сообщений запуска. Данные товаров — как их даёт Taobao.",
            "default": "en"
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}