{ "openapi": "3.0.1", "info": { "title": "Carrefour Grocery Price Scraper (UAE, KSA, Egypt)", "description": "Extracts Carrefour grocery prices in UAE, Saudi Arabia and Egypt. Input: country (AE/SA/EG) plus category names, codes or product links. Output: one JSON item per product with local-currency price, discount, unit price, stock. Use for price tracking and deals feeds. $0.002 per product.", "version": "0.1", "x-build-id": "7OQZF8kM82XdTn5LS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/alfhar~carrefour-price-tracker-mena/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-alfhar-carrefour-price-tracker-mena", "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/alfhar~carrefour-price-tracker-mena/runs": { "post": { "operationId": "runs-sync-alfhar-carrefour-price-tracker-mena", "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/alfhar~carrefour-price-tracker-mena/run-sync": { "post": { "operationId": "run-sync-alfhar-carrefour-price-tracker-mena", "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": [ "country" ], "properties": { "country": { "title": "Country", "enum": [ "EG", "AE", "SA" ], "type": "string", "description": "Which Carrefour website to read.", "default": "EG" }, "categoryKeywords": { "title": "Category names", "type": "array", "description": "Words from Carrefour category names, for example milk, rice, coffee, diapers, laptops. Every category whose name contains one of the words is scraped. Carrefour's own search page is not used because its robots.txt disallows it.", "items": { "type": "string" } }, "categoryUrls": { "title": "Category codes or links", "type": "array", "description": "Category codes (FEGY1610000), promotion pages (promo-big-discounts) or full category links copied from the Carrefour site.", "items": { "type": "string" } }, "productUrls": { "title": "Product links or IDs", "type": "array", "description": "Product page links (they contain /p/12345) or product IDs, to track a fixed list of products.", "items": { "type": "string" } }, "includeSubcategories": { "title": "Also scrape subcategories", "type": "boolean", "description": "Carrefour shows the first 60 products of a category page to crawlers. Subcategory pages add more products, up to 60 each.", "default": true }, "maxCategoryDepth": { "title": "Subcategory depth", "minimum": 0, "maximum": 3, "type": "integer", "description": "How many levels below each start category to visit.", "default": 1 }, "maxCategories": { "title": "Max category pages per run", "minimum": 1, "maximum": 300, "type": "integer", "description": "Safety limit on the number of category pages opened.", "default": 20 }, "maxProducts": { "title": "Max products per run", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Stop after this many products.", "default": 200 }, "onlyDiscounted": { "title": "Only discounted products", "type": "boolean", "description": "Keep only products that currently have a lower price than their original price.", "default": false }, "language": { "title": "Language", "enum": [ "en", "ar" ], "type": "string", "description": "Language of product names.", "default": "en" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Requests go out directly first. If Carrefour blocks them, the Actor retries through this proxy.", "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 } } } } } } } } } }