{
  "openapi": "3.0.1",
  "info": {
    "title": "RU Seller Intel: Wildberries, Avito, Yandex Market | Продавцы",
    "description": "Seller and shop intelligence for Wildberries, Avito and Yandex Market in one dataset. Wildberries: INN, OGRN, address, rating, brands, search rank. Avito: seller rating, reviews, badges, listings. Yandex Market: shops from search results. Проверка продавцов и ИНН по трем площадкам.",
    "version": "0.4",
    "x-build-id": "ZEC2GNwl6Y3RgD4df"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/getascraper~ru-marketplace-seller-intel/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-getascraper-ru-marketplace-seller-intel",
        "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/getascraper~ru-marketplace-seller-intel/runs": {
      "post": {
        "operationId": "runs-sync-getascraper-ru-marketplace-seller-intel",
        "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/getascraper~ru-marketplace-seller-intel/run-sync": {
      "post": {
        "operationId": "run-sync-getascraper-ru-marketplace-seller-intel",
        "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": {
          "marketplaces": {
            "title": "Marketplaces to query",
            "type": "array",
            "description": "Which marketplace modules to run. Each module also needs its own source list below, so a marketplace without input returns no rows. Wildberries is read from open public data. Avito and Yandex Market are read through a Russian residential proxy and return rows only when the marketplace serves the page to the Actor.",
            "items": {
              "type": "string",
              "enum": [
                "wildberries",
                "avito",
                "yandex_market"
              ],
              "enumTitles": [
                "Wildberries",
                "Avito",
                "Yandex Market"
              ]
            },
            "default": [
              "wildberries",
              "avito",
              "yandex_market"
            ]
          },
          "wildberriesSupplierIds": {
            "title": "Seller ids or seller links",
            "type": "array",
            "description": "Wildberries seller ids such as 15841, or seller page links such as https://www.wildberries.ru/seller/15841. Returns the registered company record: legal name, INN, OGRN or OGRNIP, address, trademark.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "wildberriesProducts": {
            "title": "Product article numbers or product links",
            "type": "array",
            "description": "Wildberries article numbers such as 165091954, or product page links. The seller behind each product gets a row, with the rating, review count and brand mix of the products you gave.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "wildberriesKeywords": {
            "title": "Search words",
            "type": "array",
            "description": "Search words as typed on Wildberries, for example 'ковер гостиная'. The sellers behind the top results get a row each, ranked by how many of the results are theirs.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "searchDepth": {
            "title": "Search results to read",
            "minimum": 10,
            "maximum": 300,
            "type": "integer",
            "description": "How many top results of each search word to read (up to 300). More results find more sellers and give a better view of who owns the results.",
            "default": 100
          },
          "maxSellersPerKeyword": {
            "title": "Sellers per search word",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "How many sellers to report for each search word, starting with the seller that owns the most results.",
            "default": 20
          },
          "productSampleSize": {
            "title": "Products to rate per seller",
            "minimum": 0,
            "maximum": 30,
            "type": "integer",
            "description": "For sellers found through products or search words: how many of their products to read ratings and price history for. The seller rating is the review-weighted average of these products. Set 0 to skip.",
            "default": 10
          },
          "avitoSellerUrls": {
            "title": "Avito seller profile URLs or slugs",
            "type": "array",
            "description": "Avito seller profile links (for example 'https://www.avito.ru/brands/greats') or bare slugs (for example 'greats'). Each profile that Avito serves to the Actor becomes one row with rating, review count, badges, member-since date, response time and listing counts. Needs the Russian residential proxy below.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "maxActiveListings": {
            "title": "Avito active-listings snapshot size",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "For each Avito seller, how many currently active listings to snapshot (title, price, location, link). Read from the profile page that is already fetched, so it adds no requests. Set 0 to skip.",
            "default": 10
          },
          "yandexMarketKeywords": {
            "title": "Yandex Market search keywords",
            "type": "array",
            "description": "Search words to run on Yandex Market (for example 'наушники'). Yandex Market has no seller lookup page, so shops are discovered from the distinct sellers in each search result page: name, rating, review count and how many of the results are theirs. Needs the Russian residential proxy below.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "maxSellersPerYandexKeyword": {
            "title": "Max shops per Yandex Market keyword",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "Cap on how many distinct shops to return per Yandex Market search word.",
            "default": 10
          },
          "maxItems": {
            "title": "Maximum seller rows",
            "minimum": 0,
            "maximum": 1000000,
            "type": "integer",
            "description": "Hard cap on seller rows in one run. 0 means no limit.",
            "default": 500
          },
          "monitorMode": {
            "title": "Monitor mode (only new or changed sellers)",
            "type": "boolean",
            "description": "Turn this on to track sellers over time. The Actor remembers the sellers it saw under the monitor name below and, on later runs with the same name, returns only sellers that are new or whose details changed, each tagged with changeType, firstSeen and lastSeen. Off by default: every matching seller is returned.",
            "default": false
          },
          "monitorName": {
            "title": "Monitor name",
            "type": "string",
            "description": "A short name for this monitor's memory, for example 'wb-electronics'. Re-use the same name across runs to compare against the previous run. Required when monitor mode is on. Different names keep separate memories.",
            "default": ""
          },
          "webhookUrl": {
            "title": "New-seller notification link (optional)",
            "type": "string",
            "description": "An https link that receives a POST with the new sellers found on a monitor run. Slack and Discord incoming-webhook links get a ready-to-read message; any other link gets structured JSON. Used only when monitor mode is on. Leave empty for no notification.",
            "default": ""
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Avito and Yandex Market need a Russian residential proxy (datacenter and non-Russian addresses are refused). Wildberries uses no proxy. You can also supply your own proxy URLs.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "RESIDENTIAL"
              ],
              "apifyProxyCountry": "RU"
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}