{ "openapi": "3.0.1", "info": { "title": "Fashion Nova Scraper - Products, Prices, Sizes & Reviews", "description": "Scrape Fashion Nova products by keyword, collection or URL. Extract product names, current and original prices, available sizes, size-level stock status, full image galleries and customer reviews.", "version": "0.1", "x-build-id": "pj3KCYIyeZgcesQo5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~fashionnova-com-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-fashionnova-com-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/abotapi~fashionnova-com-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-fashionnova-com-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/abotapi~fashionnova-com-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-fashionnova-com-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": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "url" ], "type": "string", "description": "How to start the scrape. 'search' runs keyword searches and collection walks. 'url' processes the Fashion Nova URLs you paste: a product link returns that product in full (all its colors), a collection link is paged like a search, and a search link's own query decides the scope.", "default": "search" }, "searchTerms": { "title": "Search terms", "type": "array", "description": "One or more things to search Fashion Nova for, for example 'dresses', 'jeans', 'swimsuit'. Each term is walked independently. Search mode only: in URL mode the scope is read out of each pasted link instead.", "items": { "type": "string" } }, "collections": { "title": "Collections to browse (handles)", "type": "array", "description": "Browse one or more store collections by handle, for example 'new' (New Arrivals), 'sale', 'jeans', 'dresses', 'womens-novadeals'. Each collection is walked independently. Search mode only.", "items": { "type": "string" } }, "urls": { "title": "Fashion Nova URLs", "type": "array", "description": "Paste Fashion Nova product or collection links; every link shape the store uses is accepted. Product links: /products/, with or without ?color=, locale prefixes and color-qualified handles are all recognized, and a product link returns all of that product's colorways. Collection links: /collections/, add &page=3 to start that walk further in. A /search?q= link is walked as a keyword search. Links to other pages (home, help, blog) are skipped. Multi-URL supported. Pagination starts at the page in the URL and walks forward.", "default": [ "https://www.fashionnova.com/products/kennedy-short-sleeve-drop-waist-mini-dress?color=black", "https://www.fashionnova.com/collections/dresses", "https://www.fashionnova.com/search?q=swimsuit" ], "items": { "type": "string" } }, "sortBy": { "title": "Sort results by", "enum": [ "relevance", "price-asc", "price-desc", "best-selling", "newest" ], "type": "string", "description": "Ordering for keyword searches and collection walks, sent with every page. 'relevance' is the store default. Price sorts are verified live. Applies in BOTH search mode and URL mode (a sort= on a pasted link is not honored; this field decides).", "default": "relevance" }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "number", "description": "Only keep rows whose price is at least this amount, in the storefront currency. Applied to the rows this run reads. Applies in BOTH search mode and URL mode; a pasted product link is the one exception and returns that product in full." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "number", "description": "Only keep rows whose price is at most this amount, in the storefront currency. Applied to the rows this run reads. Applies in BOTH search mode and URL mode; a pasted product link is the one exception and returns that product in full." }, "onSaleOnly": { "title": "Only sale items", "type": "boolean", "description": "Only keep products currently marked down: the current price is below the store's own was-price. Applied to the rows this run reads, in both modes. The current vs was price pair and the discount percent are on every row either way, so this is a convenience filter, not the only way to see sale items.", "default": false }, "availableOnly": { "title": "Only in-stock items", "type": "boolean", "description": "Only keep products the store marks in stock. Every row also carries per-size stock, so partial sellouts are visible either way.", "default": false }, "fetchDetails": { "title": "Fetch customer reviews", "type": "boolean", "description": "Read each product's customer reviews (star summary, per-star counts, fit signal and up to Max reviews below) from the store's reviews feed. Charged once per record. Leave off for a fast crawl: every catalog field (price, was-price, all sizes with stock, full image gallery, description, category, tags) is included either way.", "default": true }, "maxReviews": { "title": "Max reviews per product", "minimum": 0, "type": "integer", "description": "Cap on customer reviews carried per product when Fetch customer reviews is on. Set 0 to skip the reviews read entirely: no review pages and no star summary. Higher caps read more pages; the review unit is charged once per record that has reviews.", "default": 20 }, "maxItems": { "title": "Max items", "minimum": 0, "type": "integer", "description": "The single cap on this run: stop after collecting this many records across all search terms, collections and URLs. Set 0 for unlimited.", "default": 20 }, "maxPages": { "title": "Max pages per source", "minimum": 0, "type": "integer", "description": "Safety bound on how many result pages to walk per search term or URL. Leave empty (0) for no page limit: the run then stops at Max items, not here. Does not impose a separate cap below Max items.", "default": 0 }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Leave the default for the cheapest run. The store serves the catalog over ordinary shared connections, and Residential is recommended for the most reliable results on large or frequent runs. If a run reports it could not read any results, try Residential before anything else.", "default": { "useApifyProxy": true } }, "resumeFromRunId": { "title": "Resume from a previous run", "type": "string", "description": "Paste a previous run ID or dataset ID to continue a large crawl without returning or charging for records already collected there. Use this after an interrupted or capped run. For recurring monitoring of the same search, use Incremental mode below instead." }, "incrementalMode": { "title": "Incremental changes for scheduled runs", "type": "boolean", "description": "Turn this on for daily or weekly recurring monitoring of the same search, for example a price watch. The first run returns everything matching as NEW. Later runs normally return only NEW, UPDATED and REAPPEARED records. Price moves, was-price changes and stock changes ARE reported as UPDATED: on a store they are the signal, not noise. The customer review list, its count and rating are excluded by default (a new review is not a product change). Turn on Emit unchanged or Emit expired only when you also want those rows returned (and billed). State is kept separately per search, URL and filter setup; use State key to name or deliberately share a monitoring campaign.", "default": false }, "stateKey": { "title": "State key (optional, incremental mode only)", "type": "string", "description": "Optional. Name this monitoring campaign to keep its state stable, or to deliberately share state across differently configured runs. Leave empty to let the actor derive a key automatically from the search terms, URLs and filters, so two different searches never mix state." }, "emitUnchanged": { "title": "Emit unchanged records (incremental mode only)", "type": "boolean", "description": "Off by default. Turn on to also return records that have not changed since the last run, marked UNCHANGED. This returns, and bills, extra rows you already have, so leave it off unless you specifically want a full snapshot every run.", "default": false }, "emitExpired": { "title": "Emit expired records (incremental mode only)", "type": "boolean", "description": "Off by default. Turn on to also return records that were present in a previous run but are no longer found, marked EXPIRED. Only produced once a run has fully scanned the tracked search: not when Max items capped it, not when Resume was used, and not when the run was refused. This returns, and bills, extra synthetic rows, so leave it off unless you need expiry tracking.", "default": false }, "ignoreFieldsForChanges": { "title": "Ignore fields when detecting changes (incremental mode only)", "type": "array", "description": "Optional. Extra top-level field names to exclude from incremental change detection, on top of the built-in list (the review fields and the image gallery are already excluded by default; the first image stays tracked). Use when a field moves every run without the product changing.", "items": { "type": "string" } }, "mcpConnectors": { "title": "Pipe results into your apps (optional)", "type": "array", "description": "Optionally send results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize one under Apify, Settings, API and Integrations, then select it here. Notion gets a page per record; other connectors get a best-effort write or digest. Each connector receives a condensed summary per record, not the full record; the complete record always stays in the dataset. Leave empty to skip; this never changes the dataset output. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com)." }, "notionParentPageUrl": { "title": "Notion parent page (Notion connector only)", "type": "string", "description": "URL or id of the Notion page under which record pages are created. Required to enable the Notion export; ignored by other connectors." }, "maxNotifyListings": { "title": "Max items to export per connector", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Cap on records written to each connector per run. Does not affect the dataset.", "default": 50 } } }, "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 } } } } } } } } } }