{ "openapi": "3.0.1", "info": { "title": "AvtoPro.es/pt Competitor Price Checker", "description": "One Actor for both Iberian storefronts. Send a list of part numbers and get the lowest price, the average, and every offer on avtopro.es with the seller's name, rating and delivery city.", "version": "0.0", "x-build-id": "ro66ezgcvbez3Iitx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/climond~avtopro-es-pt-competitor-price-checker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-climond-avtopro-es-pt-competitor-price-checker", "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/climond~avtopro-es-pt-competitor-price-checker/runs": { "post": { "operationId": "runs-sync-climond-avtopro-es-pt-competitor-price-checker", "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/climond~avtopro-es-pt-competitor-price-checker/run-sync": { "post": { "operationId": "run-sync-climond-avtopro-es-pt-competitor-price-checker", "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": [ "items" ], "properties": { "items": { "title": "Parts to look up", "type": "array", "description": "One entry per part: item_id (the part code as avtopro.es lists it, required), description (free text, carried through to output), origin_price (your own price, carried through for reference), maker (your catalog's brand for this part - the strongest signal for picking the right search suggestion when a part code is ambiguous). Example: [{\"item_id\": \"03D906051\", \"description\": \"Ignition coil\", \"origin_price\": 100, \"maker\": \"VAG\"}] The prefilled basket is 8 real parts, each verified live on avtopro.es, spanning small result sets (5 offers) to large ones (201) - cost per part scales with how many sellers a part has, so a mixed basket is the honest way to see what a run costs. 'origin_price' is passed through untouched; replace it with your real figures." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "A residential proxy is required: avtopro.es blocks datacenter addresses even at low request rates. Prices come back in EUR and the Actor reports the currency it was served rather than assuming one. If Apify Proxy gets blocked, switch to Custom proxies and supply your own.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "siteUrl": { "title": "Site URL", "type": "string", "description": "Defaults to https://avtopro.es. Set it to https://avtopro.pt to price the same inventory at the Portuguese storefront - both are one seller pool, verified seller by seller, with Portuguese prices running 0.5-2% higher. avtopro.pl also serves this feed but is a separate market in zloty. avtopro.ua serves a completely different page template and will NOT work here - use the AvtoPro Ukraine Competitor Price Checker for that.", "default": "https://avtopro.es" }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 32, "type": "integer", "description": "How many parts are fetched at once, default 8. Each part gets its own proxy session, so this is I/O-bound rather than memory-bound, and a faster run is also a cheaper one because compute is billed on wall-clock time. Raising it trades a few percent of parts for speed; lower it to 2 if you would rather have every part than a fast run." } } }, "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 } } } } } } } } } }