{ "openapi": "3.0.1", "info": { "title": "Back Market Spain Scraper — Refurbished Tech", "description": "Browses any Back Market Spain category and returns every product model with its starting price, the price when new, star rating and review count as separate columns. Optionally opens each product page for the full grade, battery, storage, colour and SIM price matrix.", "version": "0.1", "x-build-id": "nxxWmNa1xORhDlVOu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/reventadata~backmarket-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-reventadata-backmarket-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/reventadata~backmarket-scraper/runs": { "post": { "operationId": "runs-sync-reventadata-backmarket-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/reventadata~backmarket-scraper/run-sync": { "post": { "operationId": "run-sync-reventadata-backmarket-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": [ "categories" ], "properties": { "categories": { "title": "Category URLs", "type": "array", "description": "One or more Back Market Spain category pages, copied straight from the address bar — for example https://www.backmarket.es/es-es/l/iphone/aabc736a-cb66-4ac0-a3b7-0f449781ed39. The slug alone is not enough: a category is addressed by its slug AND the UUID that follows it. Free-text search is deliberately not offered, because the site's robots.txt reserves its search endpoint while leaving category browsing open.", "items": { "type": "string" } }, "minPrice": { "title": "Minimum starting price (EUR)", "minimum": 0, "type": "integer", "description": "Optional, in whole euros, compared against the card's starting-from price. Applied after fetching, not sent to the site: Back Market's own price filter is a URL fragment (#price=600&price=900) which is never transmitted in an HTTP request, and its query-string spelling is silently ignored by the server. Omitted entirely when empty — never defaulted to 0." }, "maxPrice": { "title": "Maximum starting price (EUR)", "minimum": 0, "type": "integer", "description": "Optional, in whole euros, compared against the card's starting-from price. Applied after fetching, for the same reason as the minimum: the site's real price control is a URL fragment and cannot be sent by any HTTP client." }, "brands": { "title": "Brands", "type": "array", "description": "Optional. Keep only rows whose brand matches one of these, using the site's own lowercase brand value from the card — for example apple, samsung, xiaomi. Matching is case-insensitive. Applied after fetching, like the price bounds. Leave empty for every brand in the category.", "items": { "type": "string" } }, "fetchProductDetails": { "title": "Open each product page", "type": "boolean", "description": "Off by default. When on, each model's product page is fetched to add its full variant matrix — every grade, battery health, storage, colour and SIM option with its own price. It costs roughly 20 to 50 times more per row than browsing alone, about 0.88 to 1.50 USD extra per 1,000 rows against about 0.05 USD for the listing pages, because a category page carries 31 models per request and a product page carries one. Nothing row-unique lives there: the price when new is already on the listing card, and the variant matrix is one shared table per model rather than a list of individual sellers.", "default": false }, "maxItems": { "title": "Maximum rows", "minimum": 1, "type": "integer", "description": "Hard cap on rows pushed across all categories.", "default": 300 }, "maxPages": { "title": "Maximum pages per category", "minimum": 1, "maximum": 33, "type": "integer", "description": "Back Market serves at most 1,000 items per category — 32 pages of 31 models plus a partial page of 8 — no matter how large the category really is. Past that the site returns no cards AND reports '0 productos' even for a category that claimed 5,888 one page earlier, so this Actor stops at the window rather than fetching that lie. Clamped to 33.", "default": 33 } } }, "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 } } } } } } } } } }