{ "openapi": "3.0.1", "info": { "title": "Notino Scraper [$2.30/1K💰] | 27 Countries | Reviews", "description": "Scrape Notino's beauty catalog from 27 country shops - products, brands, variants, prices, currency, ratings and customer reviews. Paste a search or brand URL and get the full result set. No browser needed. Built for price monitoring and market research.", "version": "0.8", "x-build-id": "fPNrj7c6I7o2FKICr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ahmed_jasarevic~notino-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ahmed_jasarevic-notino-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/ahmed_jasarevic~notino-scraper/runs": { "post": { "operationId": "runs-sync-ahmed_jasarevic-notino-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/ahmed_jasarevic~notino-scraper/run-sync": { "post": { "operationId": "run-sync-ahmed_jasarevic-notino-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": { "searchUrls": { "title": "Search URLs", "type": "array", "description": "Notino search, brand or category pages to scrape products from. Paste the URL exactly as it appears in your browser - e.g. https://www.notino.co.uk/search/?exps=shampoo for a keyword search, or https://www.notino.co.uk/dior/ for a brand. The country shop is taken from each URL, so prices and currency follow the market you link to, and URLs from different countries can be mixed in one run. All matching products are discovered and the result set is paginated automatically using 'maxPagesPerSearchUrl'. The whole flow works without a proxy for a handful of pages; enable Apify residential proxy for deep runs.", "items": { "type": "string" } }, "maxPagesPerSearchUrl": { "title": "Max pages per search URL", "minimum": 0, "maximum": 500, "type": "integer", "description": "How many result pages to walk for each search/brand/category URL (one page holds 24 products, so 5 pages is roughly 120 products). 0 = every page.", "default": 1 }, "sortOption": { "title": "Sort option", "type": "integer", "description": "Optional. Notino's sort index used while paginating (part of the 'f={page}-{sort}' URL parameter). Leave empty to use the default." }, "productUrls": { "title": "Product URLs", "type": "array", "description": "Optional. Notino product page URLs (e.g. https://www.notino.co.uk/schwarzkopf/creme-supreme-permanent-hair-dye/p-16316126). Product IDs are extracted automatically from the /p-{id} part of each URL.", "items": { "type": "string" } }, "productIds": { "title": "Product IDs", "type": "array", "description": "Optional. Bare Notino product IDs (numeric, e.g. 16316126). Combined with IDs extracted from productUrls and discovered from searchUrls.", "items": { "type": "string" } }, "startUrls": { "title": "Other listing URLs", "type": "array", "description": "Optional. Alias of 'Search URLs' kept for existing runs. Sitemap URLs are NOT supported: sitemap entries carry SEO slugs without the /p-{id} that the API needs.", "items": { "type": "string" } }, "includeReviews": { "title": "Include product reviews", "type": "boolean", "description": "Fetch customer reviews (text, rating score, author) for each product. When enabled, reviews are written to a separate 'reviews' dataset - one row per review, each carrying the product it belongs to - instead of being nested inside the product rows. Reviews are billed as their own pay-per-event unit, so they are charged separately from products.", "default": false }, "maxReviewsPerProduct": { "title": "Max reviews per product", "minimum": 0, "maximum": 500, "type": "integer", "description": "Maximum number of reviews to fetch per product (0 = none). The API serves reviews 20 at a time and Notino's ordering is not stable, so reviews are de-duplicated by ID while paging; the highest value is 500.", "default": 20 }, "maxItems": { "title": "Max products", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Maximum number of products to scrape in one run.", "default": 10 }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Select proxies to be used by your crawler." } } }, "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 } } } } } } } } } }