{ "openapi": "3.0.1", "info": { "title": "Credo Beauty Scraper - Products, Prices, SKUs & Barcodes", "description": "Scrape the Credo Beauty clean-beauty catalogue: products, brands, prices, discounts, variant SKUs and GTIN barcodes, stock status, store taxonomy and merchandised bestseller rank. Five modes: full catalogue, collections, product URLs, search. Barcodes join to other retailers for price intelligence.", "version": "0.0", "x-build-id": "6EaFQBJDXWxIaGh1B" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/growth-installations~credo-beauty-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-growth-installations-credo-beauty-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/growth-installations~credo-beauty-scraper/runs": { "post": { "operationId": "runs-sync-growth-installations-credo-beauty-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/growth-installations~credo-beauty-scraper/run-sync": { "post": { "operationId": "run-sync-growth-installations-credo-beauty-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": [ "all_products", "collections", "collection_list", "product_urls", "search" ], "type": "string", "description": "What to scrape. Each mode uses a different Shopify endpoint and only reads its own field below.", "default": "all_products" }, "collectionHandles": { "title": "Collection handles", "type": "array", "description": "Used by Collections mode. Accepts a handle or a full collection URL.", "items": { "type": "string" } }, "productUrls": { "title": "Product URLs", "type": "array", "description": "Used by Product URLs mode. Accepts a full product URL or just the handle.", "items": { "type": "string" } }, "searchQueries": { "title": "Search queries", "type": "array", "description": "Used by Search mode. One query per line. Shopify returns at most 10 products per query.", "items": { "type": "string" } }, "enrichWithVariants": { "title": "Enrich with variant detail (SKU + barcode)", "type": "boolean", "description": "Runs a second pass that re-fetches every product from its .js endpoint to attach full variant rows: SKU, barcode (GTIN/UPC/EAN), inventory policy and per-variant price and stock. This is the only way to get SKUs in Search mode, and it adds barcodes to every other product mode. Costs one extra request per product.", "default": false }, "includePromotional": { "title": "Include promotional / placeholder items", "type": "boolean", "description": "Credo lists gift-with-purchase and loyalty placeholders as products, whose vendor shows up as 'Free Gift' or 'Credo Rewards'. These are excluded by default. Note that 'Credo Beauty' and 'Credo Skincare' are genuine house brands and are always kept.", "default": false }, "maxProducts": { "title": "Max items", "minimum": 0, "type": "integer", "description": "Stop after this many items. Set to 0 for unlimited (the full catalogue is roughly 1,200 products).", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Apify Proxy is recommended for large 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 } } }, "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 } } } } } } } } } }