{
  "openapi": "3.0.1",
  "info": {
    "title": "Boohoo Scraper | Products, Prices and Stock",
    "description": "Boohoo scraper for products, prices and stock: search boohoo, paste a category link or product codes and get price, price before discount, discount, promotion, every size with stock count and EAN barcode, composition, category path and images. 50 products in 3 seconds, 39 fields each. No login.",
    "version": "1.0",
    "x-build-id": "zCerllMTQlnVRGKIk"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/silentflow~boohoo-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-silentflow-boohoo-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/silentflow~boohoo-scraper/runs": {
      "post": {
        "operationId": "runs-sync-silentflow-boohoo-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/silentflow~boohoo-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-silentflow-boohoo-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": {
          "searchQueries": {
            "title": "🔎 Search",
            "type": "array",
            "description": "Words to search boohoo with, like on the site: <code>satin midi dress</code>, <code>wide leg jeans</code>, <code>knee high boots</code>. Each search returns its best matches first, up to the limit below. A broad word like <code>dress</code> lists tens of thousands of products.",
            "items": {
              "type": "string"
            }
          },
          "productIds": {
            "title": "🏷️ Product codes or links",
            "type": "array",
            "description": "Products to check, one per line: the boohoo product code (<code>HZZ43831</code>, shown at the end of every product link), a SKU (<code>HZZ43831-293-16</code>) or the product link (<code>https://www.boohoo.com/product/boohoo-cowl-long-sleeve-mini-dress_hzz43831</code>, any boohoo store). Each one returns its colours, sold out ones included, whatever the limit below: every code gives at least one row.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "🔗 boohoo links",
            "type": "array",
            "description": "Links copied from any boohoo store:<ul><li>a category, <code>https://www.boohoo.com/categories/womens-dresses</code>, with its filters (<code>/facet/colourFacets/Black</code>) and sort (<code>?sort=newness</code>)</li><li>a search, <code>https://us.boohoo.com/search?text=jeans</code></li><li>a product page, read like a product code above</li></ul>Each link is read on the store of its address.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "country": {
            "title": "🌍 Store",
            "type": "string",
            "description": "The boohoo store to read searches and product codes in: prices, currency, discounts and stock are those of that store. Pick one, or type a country code (<code>us</code>, <code>usa</code>) or name; a country without its own store reads the Europe and rest of world store. Links always use the store of their address.",
            "default": "gb"
          },
          "maxItems": {
            "title": "🔢 Max products per search or link",
            "minimum": 1,
            "type": "integer",
            "description": "The most products (one row per colour) returned for each search and each category or search link. Never cuts your list of product codes: every code always returns its row. Large values are fine: in our test, 2,500 products of one category took 7 seconds with size details off.",
            "default": 50
          },
          "sort": {
            "title": "↕️ Sort",
            "enum": [
              "relevance",
              "newness",
              "best-sellers",
              "price-asc",
              "price-desc"
            ],
            "type": "string",
            "description": "The order of searches and category links, like the sort menu of the site. <b>Newness</b> catches new arrivals first, <b>Best sellers</b> what sells. A sort written in a link (<code>?sort=newness</code>) wins for that link.",
            "default": "relevance"
          },
          "brands": {
            "title": "👗 Brands",
            "type": "array",
            "description": "Keep only these brands, spelled as on the site: <code>boohoo</code>, <code>boohooMAN</code>, <code>PrettyLittleThing</code>, <code>Karen Millen</code>, <code>Coast</code>. boohoo also sells partner brands, so this keeps a category to the house brands. Alone, with no search or link, it lists every product of these brands. Leave empty for every brand.",
            "items": {
              "type": "string"
            }
          },
          "includeDetails": {
            "title": "📏 Size stock and barcodes",
            "type": "boolean",
            "description": "Add every size of each colour, sold out sizes included, with its stock count, SKU, EAN barcode and price, plus the promotion applied and the delivery badges. Turn off for faster price checks on very large catalogs: rows then list the sizes in stock only.",
            "default": true
          },
          "debugMode": {
            "title": "🐞 Debug mode",
            "type": "boolean",
            "description": "Write detailed progress to the log.",
            "default": false
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}