{
  "openapi": "3.0.1",
  "info": {
    "title": "Taobao & Tmall 淘宝 Search & Shops · Поиск и магазины Taobao",
    "description": "Search Taobao and Tmall by keyword: price, photos, sales in sorted searches. Shop products with shop scores. Full records, translation, your currency, agent links. Поиск по Taobao и Tmall: цена, фото, продажи при сортировке. Товары магазинов с оценками. Карточки, перевод, валюта, ссылки байеров.",
    "version": "0.1",
    "x-build-id": "kJuEjnujUNanR5E9k"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/theshark~taobao-search-shop-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-theshark-taobao-search-shop-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/theshark~taobao-search-shop-scraper/runs": {
      "post": {
        "operationId": "runs-sync-theshark-taobao-search-shop-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/theshark~taobao-search-shop-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-theshark-taobao-search-shop-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": {
          "keywords": {
            "title": "Search words · Поисковые слова",
            "type": "array",
            "description": "One search per line; Chinese words work best (for example 手机壳, a phone case). Plain search lists up to 1,000 products over 50 pages. With a sort other than Relevance, Tmall only or a price range a search gives one page of up to 10 products (up to 20 with a price range alone). Up to 100 searches and shops per run.<br><br>По запросу на строку; лучше всего работают китайские слова (например 手机壳, чехол для телефона). Обычный поиск даёт до 1000 товаров на 50 страницах. С сортировкой не по релевантности, «Только Tmall» или диапазоном цены поиск даёт одну страницу — до 10 товаров (до 20 с одним диапазоном цены). До 100 запросов и магазинов за запуск.",
            "items": {
              "type": "string"
            }
          },
          "shops": {
            "title": "Shops · Магазины",
            "type": "array",
            "description": "One shop per line: a shop link (shop12345678.taobao.com, the mobile one too) or the seller's numeric ID (sellerId). A number is read as the seller ID, not the number from the shop link: for a shop you know by its link, give the link itself. You get the shop's products, best sellers first, up to 2,060 per shop (Taobao shows no more). Up to 100 searches and shops per run.<br><br>По магазину на строку: ссылка магазина (shop12345678.taobao.com, мобильная тоже) или числовой ID продавца (sellerId). Число — это ID продавца, а не номер из ссылки магазина: магазин, который вы знаете по ссылке, давайте самой ссылкой. Товары магазина, сначала самые продаваемые, до 2060 на магазин (больше Taobao не показывает). До 100 запросов и магазинов за запуск.",
            "items": {
              "type": "string"
            }
          },
          "max_items": {
            "title": "Products per search or shop · Товаров на запрос или магазин",
            "minimum": 20,
            "maximum": 2060,
            "type": "integer",
            "description": "How many products to take per search and per shop: one number for the whole run. With search words it is at most 1,000, shops included; without search words a shop can give up to 2,060. From 20: rows come in pages of 20. You pay per product row.<br><br>Сколько товаров брать на запрос и на магазин: одно число на весь запуск. Со словами для поиска — не больше 1000, магазины тоже; без слов магазин даёт до 2060. От 20: строки приходят страницами по 20. Платите за строку товара.",
            "default": 100
          },
          "sort": {
            "title": "Sort searches by · Сортировка поиска",
            "enum": [
              "relevance",
              "popular",
              "price_desc"
            ],
            "type": "string",
            "description": "Order of search results. Most popular and Price, high to low give one page of up to 10 products and do not combine with a price range. Shops are always sorted by best sellers.<br><br>Порядок результатов поиска. «Самые популярные» и «Цена по убыванию» дают одну страницу — до 10 товаров — и не сочетаются с диапазоном цены. Магазины всегда идут по продажам.",
            "default": "relevance"
          },
          "tmall_only": {
            "title": "Tmall only · Только Tmall",
            "type": "boolean",
            "description": "Search only Tmall products. Gives one page of up to 10 products.<br><br>Искать только товары Tmall. Даёт одну страницу — до 10 товаров.",
            "default": false
          },
          "min_price": {
            "title": "Lowest price, CNY · Цена от, ¥",
            "minimum": 0,
            "type": "integer",
            "description": "Search only products from this price, in yuan. A price range gives one page of up to 20 products (up to 10 together with Tmall only).<br><br>Искать товары от этой цены, в юанях. Диапазон цены даёт одну страницу — до 20 товаров (до 10 вместе с «Только Tmall»)."
          },
          "max_price": {
            "title": "Highest price, CNY · Цена до, ¥",
            "minimum": 0,
            "type": "integer",
            "description": "Search only products up to this price, in yuan.<br><br>Искать товары до этой цены, в юанях."
          },
          "include_details": {
            "title": "Product details · Карточки товаров",
            "type": "boolean",
            "description": "After each result add the full product row: every variant with price and stock, attributes, photos and the shop. You pay for it on top of the result row. Not on the Apify free plan.<br><br>После каждого результата добавить полную строку товара: все варианты с ценой и остатком, характеристики, фото и магазин. Оплачивается сверх строки результата. На бесплатном тарифе Apify недоступно.",
            "default": false
          },
          "translate_to": {
            "title": "Translate to · Перевести на",
            "enum": [
              "none",
              "en",
              "ru",
              "es",
              "pt",
              "de",
              "fr",
              "pl"
            ],
            "type": "string",
            "description": "Translate product titles. The Chinese original stays next to the translation. A title that is already in English stays as it is. Included in the price.<br><br>Перевести названия товаров. Китайский оригинал остаётся рядом с переводом. Название, уже написанное по-английски, остаётся как есть. Входит в цену.",
            "default": "none"
          },
          "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. 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}