{ "openapi": "3.0.1", "info": { "title": "Fragrantica Scraper - Perfume Notes, Accords, Ratings", "description": "Scrape Fragrantica perfumes by keyword, brand, note, family, perfumer, gender and year: note pyramid, accords with strength, rating, votes, reviews, perfumers, launch year, description and similar perfumes. Perfume and designer links work. Error rows are free.", "version": "0.1", "x-build-id": "TcwQ423tFgD4I5AIr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapewise~fragrantica-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapewise-fragrantica-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/scrapewise~fragrantica-scraper/runs": { "post": { "operationId": "runs-sync-scrapewise-fragrantica-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/scrapewise~fragrantica-scraper/run-sync": { "post": { "operationId": "run-sync-scrapewise-fragrantica-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 keywords", "type": "array", "description": "Perfume names, brands or words to search, one per line, for example vanilla, Baccarat Rouge or oud. Each keyword is one search. Can be left empty when you use the filters below.", "items": { "type": "string" } }, "brands": { "title": "Brands", "type": "array", "description": "Only perfumes from these brands, as the site writes them, for example Dior, Tom Ford or Maison Francis Kurkdjian. Empty = all brands.", "items": { "type": "string" } }, "gender": { "title": "Gender", "enum": [ "any", "female", "male", "unisex" ], "type": "string", "description": "Only perfumes for this gender, as Fragrantica classifies them.", "default": "any" }, "notes": { "title": "Notes", "type": "array", "description": "Only perfumes that have all these notes, for example Tonka Bean, Oud or Bergamot. Empty = any notes.", "items": { "type": "string" } }, "olfactoryFamilies": { "title": "Olfactory families", "type": "array", "description": "Only perfumes in one of these families, for example Oriental Vanilla, Woody Aromatic or Floral Fruity. Empty = any family.", "items": { "type": "string" } }, "perfumers": { "title": "Perfumers", "type": "array", "description": "Only perfumes signed by one of these perfumers, for example Francis Kurkdjian or Alberto Morillas. Empty = any perfumer.", "items": { "type": "string" } }, "yearFrom": { "title": "Launched from (year)", "minimum": 1700, "maximum": 2100, "type": "integer", "description": "Only perfumes launched in this year or later." }, "yearTo": { "title": "Launched up to (year)", "minimum": 1700, "maximum": 2100, "type": "integer", "description": "Only perfumes launched in this year or earlier." }, "minVotes": { "title": "Minimum rating votes", "minimum": 0, "type": "integer", "description": "Only perfumes with at least this many rating votes, for example 500 to skip obscure releases." }, "sortBy": { "title": "Sort by", "enum": [ "popularity", "rating", "longevity", "sillage" ], "type": "string", "description": "Order of the results, the same orders the site offers in its search.", "default": "popularity" }, "startUrls": { "title": "Links", "type": "array", "description": "Optional: Fragrantica perfume links (one row each), designer pages (every perfume of the brand) or search links copied from the site.", "items": { "type": "string" } }, "includeDetails": { "title": "Notes, accords and perfumers", "type": "boolean", "description": "On: opens each perfume page for the note pyramid, accords with their strength, perfumers, family, description and similar perfumes. Off: much faster, only the search fields (name, brand, year, gender, rating, votes, reviews, image).", "default": true }, "maxItems": { "title": "Max perfumes", "minimum": 0, "type": "integer", "description": "Hard cap for the whole run, across all searches. 0 = no cap (the site search returns up to 1,000 perfumes per search).", "default": 50 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy by default. Change it only if you know you need to. If the site refuses the proxy, rows may carry the search fields only.", "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 } } } } } } } } } }