{ "openapi": "3.0.1", "info": { "title": "Oscaro Scraper — EUR Prices & Price Monitor", "description": "Scrape Oscaro parts by name or OE reference. Save the EUR price, public price, brand, reference, and stock, then alert on new parts and price or stock changes.", "version": "0.1", "x-build-id": "ae5zmmQI8C2nPCQSs" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawloop~oscaro-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawloop-oscaro-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/crawloop~oscaro-scraper/runs": { "post": { "operationId": "runs-sync-crawloop-oscaro-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/crawloop~oscaro-scraper/run-sync": { "post": { "operationId": "run-sync-crawloop-oscaro-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": [ "queries" ], "properties": { "queries": { "title": "Part searches", "type": "array", "description": "French part name or OE / manufacturer reference. Each entry is its own search. Example: plaquette de frein or GDB1330.", "items": { "type": "string" } }, "scrapeMode": { "title": "Scrape mode", "enum": [ "overview", "detail" ], "type": "string", "description": "Overview saves price, brand, reference, EAN, stock, and a short cross-reference list. Detail adds the TecDoc spec table and a longer cross-reference list from the same search hit.", "default": "overview" }, "brand": { "title": "Brand", "type": "string", "description": "Optional manufacturer filter, for example BOSCH. Use the catalog label." }, "genartId": { "title": "Part type id", "type": "string", "description": "Optional TecDoc generic-article id, for example 402 for a brake-pad set. The genartId field on a previous row is the value to paste." }, "available": { "title": "In stock only", "type": "boolean", "description": "When on, keep only parts the catalog marks as available.", "default": false }, "promo": { "title": "On promotion only", "type": "boolean", "description": "When on, keep only parts currently on promotion.", "default": false }, "universal": { "title": "Universal fit only", "type": "boolean", "description": "When on, keep only parts marked as fitting any vehicle.", "default": false }, "maxItems": { "title": "Max saved parts", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum parts to save across all searches. In monitor mode this caps alerts, not how many parts are scanned.", "default": 100 }, "maxPages": { "title": "Max pages per search", "minimum": 1, "maximum": 1, "type": "integer", "description": "The catalog returns the first results page, about 50 parts. Further pages are not included.", "default": 1 }, "monitorMode": { "title": "Monitor mode", "type": "boolean", "description": "The first run saves a baseline and returns parts up to Max saved parts. Later runs with the same monitor store save and charge only new parts, price changes, and stock or promo changes. Pair with an Apify Schedule.", "default": false }, "monitorStoreName": { "title": "Monitor store name", "type": "string", "description": "Named key-value store for prices already seen. Use one name per watch so schedules do not overwrite each other.", "default": "oscaro-monitor" }, "resetMonitorState": { "title": "Reset monitor state", "type": "boolean", "description": "Clear the saved baseline before this run. The run then saves a new baseline.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "On by default. The catalog search answers from a normal connection, and asks for a browser check from the platform, so a run uses a residential proxy.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "FR" } } } }, "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 } } } } } } } } } }