{
  "openapi": "3.0.1",
  "info": {
    "title": "Yandex Market Scraper (Парсер Яндекс Маркет) - Product Data",
    "description": "Парсер Яндекс Маркет — extract product data from Russia's largest marketplace. Prices, ratings, reviews, specs, seller info, images, and stock levels. Filter by price, category, brand, and region. For price monitoring, competitor analysis, and e-commerce research. No account needed, real-time data.",
    "version": "0.0",
    "x-build-id": "AA2cpWSkXhyb7qoKq"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/zen-studio~yandex-market-scraper-parser/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-zen-studio-yandex-market-scraper-parser",
        "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/zen-studio~yandex-market-scraper-parser/runs": {
      "post": {
        "operationId": "runs-sync-zen-studio-yandex-market-scraper-parser",
        "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/zen-studio~yandex-market-scraper-parser/run-sync": {
      "post": {
        "operationId": "run-sync-zen-studio-yandex-market-scraper-parser",
        "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": [
          "query"
        ],
        "properties": {
          "query": {
            "title": "Search query",
            "type": "string",
            "description": "Product search query in Russian or English (e.g. \"ноутбук\", \"iPhone 16\", \"кроссовки nike\").<br><br>You can also paste a full Yandex Market search URL — the keyword and basic filters (category, sort, price range) will be extracted automatically. Advanced URL filters (brand/vendor, multi-category) are not supported and will be ignored — use the fields below instead."
          },
          "maxItems": {
            "title": "Maximum products",
            "minimum": 1,
            "type": "integer",
            "description": "Limit the number of products to scrape. Leave empty to scrape all available results (up to ~2,700 per query)."
          },
          "region": {
            "title": "Region",
            "enum": [
              "213",
              "2",
              "54",
              "43",
              "65",
              "69",
              "51",
              "39",
              "35",
              "56",
              "61",
              "47",
              "62",
              "63",
              "66",
              "68"
            ],
            "type": "string",
            "description": "Yandex Market region. Affects prices, delivery, and product availability.",
            "default": "213"
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "dpop",
              "aprice",
              "dprice",
              "rating"
            ],
            "type": "string",
            "description": "Sort order for results"
          },
          "priceFrom": {
            "title": "Minimum price (₽)",
            "minimum": 0,
            "type": "integer",
            "description": "Minimum price filter in rubles"
          },
          "priceTo": {
            "title": "Maximum price (₽)",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum price filter in rubles"
          },
          "categoryId": {
            "title": "Category",
            "enum": [
              "90402",
              "13199877",
              "90428",
              "90461",
              "90403",
              "90404",
              "90435",
              "90455",
              "90477",
              "90478",
              "90497",
              "10613544",
              "10613523",
              "6269371",
              "90462",
              "8475840",
              "90518",
              "90540",
              "60113864",
              "50921244",
              "15754673",
              "818955",
              "16283321",
              "90537",
              "989939",
              "90530",
              "14424250",
              "16074646",
              "6091783",
              "14456422",
              "198118",
              "14290574",
              "237418",
              "90581",
              "90580",
              "90589",
              "90595",
              "90584",
              "90574",
              "90565",
              "90575",
              "90578",
              "90577",
              "734595",
              "10606704",
              "237420",
              "15450081",
              "90579",
              "12327609",
              "12327560",
              "90563",
              "16126061",
              "90571",
              "922553",
              "278373",
              "90567",
              "90570",
              "91161",
              "51945958",
              "90685",
              "90689",
              "16879916",
              "15979213",
              "90690",
              "13333758",
              "13041507",
              "91011",
              "91052",
              "91013",
              "91122",
              "186461",
              "91117",
              "10972670",
              "16112364",
              "90555",
              "14334315",
              "14333188",
              "16309373",
              "91031",
              "91028",
              "91020",
              "191211",
              "91019",
              "10785222",
              "6427100",
              "91491",
              "8353924",
              "10682647",
              "7798524",
              "10785221",
              "4684840",
              "91172",
              "90719",
              "13793399",
              "6206161",
              "13793828",
              "13792607",
              "11917855",
              "13771160",
              "4983619",
              "13792950",
              "91613",
              "13793701",
              "90764",
              "989028",
              "52378846",
              "13491296",
              "90783",
              "15797254",
              "10752658",
              "15797242",
              "10790728",
              "90748",
              "191214",
              "13626237",
              "13858702",
              "14459058",
              "91046",
              "15797243",
              "13858202",
              "91522",
              "13858268",
              "90752",
              "13858925",
              "90666",
              "23582210",
              "91298",
              "90714",
              "6179129",
              "11917806",
              "90680",
              "90679",
              "90708",
              "90692",
              "90667",
              "7774309",
              "10607801",
              "90801",
              "14312405",
              "14258760",
              "17725598",
              "91242",
              "15083319",
              "16056423",
              "17728967",
              "54852142",
              "90813",
              "16087732",
              "995914",
              "51041282",
              "90829",
              "283662",
              "54863686",
              "18540670",
              "38600150",
              "90846",
              "18541070",
              "18540910",
              "1001664",
              "7692671",
              "18540470",
              "18540110",
              "27483870",
              "54863821",
              "90509",
              "91159",
              "91182",
              "8475933",
              "91186",
              "14420679",
              "8480736",
              "13314820",
              "15927546",
              "8480712",
              "8478945",
              "7286147",
              "90675",
              "12457459",
              "11917783",
              "1031249",
              "11917790",
              "91009",
              "90626",
              "15618862",
              "91018",
              "857707",
              "16309374",
              "91033",
              "10604386",
              "288003",
              "91032",
              "6042233",
              "12382295",
              "10604359",
              "91113",
              "90729",
              "10604368",
              "90728",
              "10604398",
              "91128",
              "91083",
              "723087",
              "91029",
              "91763",
              "91771",
              "10614958",
              "1009493",
              "3465066",
              "6144280",
              "16379784",
              "13403092",
              "766157",
              "91801",
              "14716484",
              "16444422",
              "10614955",
              "4767715",
              "91777",
              "6374341",
              "91764",
              "281933",
              "7877999",
              "818863",
              "15064473",
              "52710577",
              "53543980",
              "53253309",
              "53546331",
              "91307",
              "16155381",
              "91349",
              "15719792",
              "15720526",
              "91337",
              "91374",
              "15756484",
              "91308",
              "12252125",
              "15714684",
              "91302",
              "15752166",
              "15714670",
              "15720040",
              "16440100",
              "91380",
              "91404",
              "91391",
              "91512",
              "14436406",
              "278348",
              "91528",
              "91529",
              "1005463",
              "10616638",
              "10616664",
              "15832723",
              "91514",
              "13088574",
              "7070735",
              "91575",
              "294675",
              "10616651",
              "14334539",
              "18024136",
              "91523",
              "91518",
              "91597",
              "14454143",
              "16207941",
              "12333788",
              "1618974",
              "91633",
              "91704",
              "91609",
              "12515112",
              "12333652",
              "91697",
              "6290271",
              "6290268",
              "6290384",
              "6290276",
              "14695400",
              "6290261",
              "6296079",
              "6290273",
              "16344890",
              "13744375",
              "53179444",
              "16339999",
              "6290266",
              "6290278",
              "15553892",
              "90613",
              "90639",
              "91148",
              "13625669",
              "13626553",
              "15521857",
              "13625804",
              "15797252",
              "15524023",
              "13625984",
              "15521377",
              "15984085",
              "13626649",
              "13626299",
              "91284",
              "17940630",
              "14960839",
              "10983253",
              "13371306",
              "198119",
              "294661",
              "91503",
              "4165204",
              "90548",
              "2724669",
              "2417247",
              "91112",
              "91497",
              "91499",
              "60512327",
              "91464",
              "10498025",
              "12410815",
              "14369750",
              "91273",
              "91277",
              "1033669",
              "16742492",
              "1033670",
              "91274",
              "16742503",
              "91280",
              "16742536",
              "91275",
              "91276",
              "22650701",
              "6206932"
            ],
            "type": "string",
            "description": "Filter results by Yandex Market category. Leave empty for all categories."
          },
          "enrichProducts": {
            "title": "Enrich with product page data",
            "type": "boolean",
            "description": "Fetch each product's page for specs, seller info, images, and description. Disable for faster search-only scraping.",
            "default": true
          },
          "includeReviews": {
            "title": "Include reviews",
            "type": "boolean",
            "description": "Fetch all review texts for each product's seller — pros, cons, comments, author, rating, helpful votes. Requires enrichment enabled. Charged separately per review.",
            "default": false
          },
          "proxyUrl": {
            "title": "Custom proxy URL",
            "type": "string",
            "description": "Custom proxy URL (e.g. http://user:pass@host:port). Falls back to Apify residential proxy."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}