{
  "openapi": "3.0.1",
  "info": {
    "title": "SHEIN Product Scraper",
    "description": "Get SHEIN product data by URL, goods ID or SKU, or browse whole categories. Clean JSON: price in local currency and USD, full-res images, colour variants, rating, stock, size-fit. 40+ regions. From $5/1,000 results.",
    "version": "0.5",
    "x-build-id": "XVN1WTZogvvw3dpIu"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/native_emblem~shein-product-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-native_emblem-shein-product-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/native_emblem~shein-product-scraper/runs": {
      "post": {
        "operationId": "runs-sync-native_emblem-shein-product-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/native_emblem~shein-product-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-native_emblem-shein-product-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": {
          "categoryUrls": {
            "title": "Category links (browse)",
            "type": "array",
            "description": "SHEIN category page links, e.g. https://www.shein.co.uk/Women-Dresses-c-12472.html. Open a category from SHEIN's menu and copy the link: links with \"-c-\" work, curated selection pages with \"-sc-\" don't. Each link's storefront sets the region unless Country is set. Returns up to \"Max products per category\" products from each link (100 by default) with price, images, rating and stock. One link reaches at most about 3,500 products, because SHEIN doesn't list more than that per category. For a bigger category, add its subcategories as separate links.",
            "items": {
              "type": "string"
            }
          },
          "categoryIds": {
            "title": "Category IDs (browse)",
            "type": "array",
            "description": "Same as category links, by number: the digits after \"-c-\" in a category link (12472 in Women-Dresses-c-12472.html). Uses Country for the region.",
            "items": {
              "type": "string"
            }
          },
          "maxProductsPerTerm": {
            "title": "Max products per category (default 100)",
            "minimum": 1,
            "type": "integer",
            "description": "How many products to return from each category link or ID. The default is 100, so raise it for a bigger pull. One category link gives at most about 3,500 products; past that, use subcategories. Max items (total) further down still caps the whole run.",
            "default": 100
          },
          "sort": {
            "title": "Sort order",
            "enum": [
              "",
              "10",
              "11"
            ],
            "type": "string",
            "description": "Order for category browsing. Recommended gives the widest coverage of a category; on large pulls the later results aren't in recommended order. \"Price: high to low\" returns nothing for the US at the moment, so US runs with it fall back to Recommended and say so in the run's status message.",
            "default": ""
          },
          "searchTerms": {
            "title": "Title filter (with categories)",
            "type": "array",
            "description": "Optional. With category links or IDs, keep only products whose title contains one of these words (e.g. \"dress\", \"cargo\"). Keyword search on its own is no longer available. Use category links, Product URLs or Goods IDs.",
            "items": {
              "type": "string"
            }
          },
          "productUrls": {
            "title": "Product URLs (detail)",
            "type": "array",
            "description": "SHEIN product page URLs (any region, e.g. www.shein.co.uk, us.shein.com, de.shein.com). The goods_id and region are parsed from each URL. Returns the full detail record, with every size's stock and price.",
            "items": {
              "type": "string"
            }
          },
          "goodsIds": {
            "title": "Goods IDs (detail)",
            "type": "array",
            "description": "SHEIN goods_id values, as an alternative (or in addition) to URLs. Combine with Country to set the region.",
            "items": {
              "type": "string"
            }
          },
          "skus": {
            "title": "SKUs (detail)",
            "type": "array",
            "description": "SHEIN SKUs (the `sku` / goods_sn value, e.g. sz260429143242426816727). Returns the same full detail record as a product URL. Combine with Country to set the region.",
            "items": {
              "type": "string"
            }
          },
          "country": {
            "title": "Country",
            "type": "string",
            "description": "ISO country code for pricing/locale (e.g. GB, US, DE, FR). Sets the region/currency for category IDs and Goods IDs, and overrides the region parsed from product and category links."
          },
          "currency": {
            "title": "Currency override",
            "type": "string",
            "description": "Optional currency override (e.g. GBP, USD, EUR). Defaults to the country's currency."
          },
          "maxItems": {
            "title": "Max items (total)",
            "minimum": 1,
            "type": "integer",
            "description": "Stop after pushing this many records across all categories and products. Leave empty for no limit."
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Apify Proxy is recommended for reliability on larger runs.",
            "default": {
              "useApifyProxy": true
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}