{
  "openapi": "3.0.1",
  "info": {
    "title": "Shein Search Products Scraper",
    "description": "SHEIN Search Products Scraper — Search and extract SHEIN product data, including names, prices, images, ratings, reviews, categories, availability, and product URLs. Useful for fashion research, price comparison, competitor analysis, and e-commerce market insights.",
    "version": "0.1",
    "x-build-id": "XCjRAfSoaQ2NwJy5E"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/fastdataapi~shein-search-products-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-fastdataapi-shein-search-products-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/fastdataapi~shein-search-products-scraper/runs": {
      "post": {
        "operationId": "runs-sync-fastdataapi-shein-search-products-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/fastdataapi~shein-search-products-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-fastdataapi-shein-search-products-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",
        "required": [
          "query"
        ],
        "properties": {
          "query": {
            "title": "🔎 Search terms",
            "type": "array",
            "description": "What to search for on Shein, one search term per line (for example jacket, summer dress, sneakers). Each search term is searched separately and its products are labelled with it.",
            "default": [
              "jacket"
            ],
            "items": {
              "type": "string"
            }
          },
          "countryCode": {
            "title": "📍 Country store",
            "enum": [
              "us",
              "de",
              "fr",
              "it",
              "ch",
              "pl",
              "pt",
              "es",
              "se",
              "uk",
              "ca",
              "mx",
              "br",
              "ae",
              "sa",
              "ru",
              "jp",
              "kr",
              "cn",
              "tw",
              "hk",
              "au",
              "in",
              "id",
              "ph",
              "my",
              "sg",
              "tr",
              "nl",
              "be",
              "at",
              "dk",
              "no",
              "fi",
              "ie",
              "vn",
              "th",
              "il"
            ],
            "type": "string",
            "description": "Which Shein country store to search; results come from that store. Belgium, Denmark, Finland, Ireland and Norway are searched in Shein's EU store, UAE and Saudi Arabia in Shein's Arabic store, and China in Shein's global store.",
            "default": "us"
          },
          "orderBy": {
            "title": "🔃 Sort order",
            "enum": [
              "recommend",
              "MostPopular",
              "NewArrivals",
              "TopRated",
              "PriceLowtoHigh",
              "PriceHightoLow"
            ],
            "type": "string",
            "description": "Order of the search results. It decides which products are collected first when your limit is lower than the number of results.",
            "default": "recommend"
          },
          "maxItems": {
            "title": "🔢 Max products per search term",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Maximum number of products to save for each search term (1-10000). Fewer rows come back when Shein has fewer results or when a product was already saved under an earlier search term. Free plan: up to 20 products per run (all search terms together) and 200 per month; paid plans have no limit.",
            "default": 10
          },
          "page": {
            "title": "🔢 Start page",
            "minimum": 1,
            "type": "integer",
            "description": "Results page to start from (1 = first page). Use it to continue a search where an earlier run stopped.",
            "default": 1
          },
          "perPage": {
            "title": "🔢 Products per page",
            "enum": [
              "20",
              "40",
              "60",
              "80",
              "100",
              "120"
            ],
            "type": "string",
            "description": "How many products each results page holds (20-120). Larger pages need fewer page loads.",
            "default": "120"
          },
          "filter": {
            "title": "🎯 Attribute filter IDs",
            "type": "string",
            "description": "Optional Shein attribute filter IDs (for example a color or size filter), as they appear in the link of a filtered Shein results page. Leave empty for no filter.",
            "default": ""
          },
          "categoryId": {
            "title": "🎯 Category ID",
            "type": "string",
            "description": "Optional Shein category ID to limit results to one category (the categoryId column of earlier results shows these IDs). Leave empty for all categories.",
            "default": ""
          },
          "minPrice": {
            "title": "🎯 Min price",
            "type": "string",
            "description": "Optional minimum price in the store's currency (for example 10). Leave empty for no minimum.",
            "default": ""
          },
          "maxPrice": {
            "title": "🎯 Max price",
            "type": "string",
            "description": "Optional maximum price in the store's currency (for example 100). Leave empty for no maximum.",
            "default": ""
          },
          "dedupeAcrossQueries": {
            "title": "✅ Skip duplicates across search terms",
            "type": "boolean",
            "description": "When on, a product that shows up under several search terms in one run is saved and charged only once, under the first search term that found it.",
            "default": true
          },
          "proxyConfiguration": {
            "title": "🌐 Proxy",
            "type": "object",
            "description": "Runs use an Apify residential proxy. If you pick a different proxy here and it returns no products, the Actor switches to a residential proxy and retries."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}