{ "openapi": "3.0.1", "info": { "title": "Pepper Deals Scraper", "description": "Scrape hot and new feeds, keyword searches, category or merchant listings, and individual deal pages from seven Pepper sites. The Actor returns normalized deal records with community scores, voucher details, merchant and category data, comments, images and links.", "version": "0.1", "x-build-id": "sKzZ7Z6jqa51wbvri" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/axiomworks~pepper-deals-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-axiomworks-pepper-deals-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/axiomworks~pepper-deals-scraper/runs": { "post": { "operationId": "runs-sync-axiomworks-pepper-deals-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/axiomworks~pepper-deals-scraper/run-sync": { "post": { "operationId": "run-sync-axiomworks-pepper-deals-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": { "sites": { "title": "Sites", "type": "array", "description": "Pepper-network sites to scrape: dealabs (FR), mydealz (DE), pepper_pl (PL), pelando (BR), hotukdeals (GB), chollometro (ES), preisjaeger (AT). Used with feed or searchTerms; ignored when only startUrls are given.", "items": { "type": "string", "enum": [ "dealabs", "mydealz", "pepper_pl", "pelando", "hotukdeals", "chollometro", "preisjaeger" ], "enumTitles": [ "Dealabs (France)", "MyDealz (Germany)", "Pepper.pl (Poland)", "Pelando (Brazil)", "hotukdeals (UK)", "Chollometro (Spain)", "Preisjaeger (Austria)" ] }, "default": [ "dealabs" ] }, "feed": { "title": "Feed", "enum": [ "hot", "new" ], "type": "string", "description": "Which listing to read on each selected site: 'hot' (hottest deals) or 'new' (newest deals). Ignored when searchTerms are given.", "default": "hot" }, "searchTerms": { "title": "Search terms", "type": "array", "description": "Optional keywords to search on every selected site instead of the feed, e.g. 'airpods' or 'lego'. One search per term and site.", "default": [], "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Optional Pepper-network listing URLs (hot, new, search, category, merchant, page N) or single deal URLs, e.g. https://www.mydealz.de/hot. Pelando: /mais-quentes, /recentes, /busca/, /c/, /d/. If set without searchTerms, only these URLs are scraped.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of deals to save in total, 1-10000, default 50. Split across all sources; the run stops once this many are saved.", "default": 50 }, "maxPagesPerSource": { "title": "Max pages per source", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum listing pages (30 deals each) or Pelando API calls (20 deals each) read per source, 1-100, default 10.", "default": 10 }, "hideExpired": { "title": "Hide expired deals", "type": "boolean", "description": "If true, deals marked expired are dropped. Default false.", "default": false }, "minTemperature": { "title": "Minimum temperature", "type": "integer", "description": "Optional. Drop deals whose temperature (community vote score) is below this number, e.g. 100. Pelando uses a different scale than Pepper sites." }, "dealTypes": { "title": "Deal types", "type": "array", "description": "Which record types to keep: 'deal' and/or 'voucher'. Default both.", "items": { "type": "string", "enum": [ "deal", "voucher" ], "enumTitles": [ "Deals", "Vouchers" ] }, "default": [ "deal", "voucher" ] }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy settings. Datacenter proxy is the default; a site that keeps blocking requests is switched to residential proxy automatically.", "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 } } } } } } } } } }