{ "openapi": "3.0.1", "info": { "title": "Todocoleccion Scraper — Antiques & Auctions", "description": "Browses any todocoleccion.net category and returns every lot with its price, auction end time, bid count and offer flag as separate columns. Fixed-price and auction lots are modelled apart, so you can filter to one or the other.", "version": "0.1", "x-build-id": "IIrD71S0ZBTOKAXIj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/reventadata~todocoleccion-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-reventadata-todocoleccion-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~todocoleccion-scraper/runs": { "post": { "operationId": "runs-sync-reventadata-todocoleccion-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~todocoleccion-scraper/run-sync": { "post": { "operationId": "run-sync-reventadata-todocoleccion-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 slugs", "type": "array", "description": "One or more todocoleccion.net category slugs, taken from the address bar of a category page — /s/relojes gives the slug 'relojes'. Each is browsed in turn. Free-text search is deliberately not offered: the site's robots.txt reserves its search endpoint, and explicitly re-allows paged category browsing instead.", "items": { "type": "string" } }, "saleType": { "title": "Sale type", "enum": [ "any", "fixed", "auction" ], "type": "string", "description": "Fixed-price only uses the site's own /venta-directa listing, which removes every auction lot server-side. Auctions only is applied after fetching, because the site publishes no auctions-only listing of its own.", "default": "any" }, "minPrice": { "title": "Minimum price (EUR)", "minimum": 0, "type": "integer", "description": "Optional, in whole euros. Omitted from the request entirely when empty — never defaulted to 0. Sent as the site's own preciodesde filter." }, "maxPrice": { "title": "Maximum price (EUR)", "minimum": 0, "type": "integer", "description": "Optional, in whole euros. Sent as the site's own preciohasta filter when it is the only bound given. If you set a minimum as well, the maximum is applied after fetching instead — todocoleccion.net answers HTTP 403 to any request carrying both price bounds at once." }, "sortBy": { "title": "Sort order", "enum": [ "default", "priceAsc", "priceDesc" ], "type": "string", "description": "Order only; changes nothing about which lots exist. Cheapest first fills with 0,01 EUR lots and most expensive first with five-figure outliers, so pair either with a price bound for a usable band. Only the two sort values confirmed to change the results are offered.", "default": "default" }, "fetchItemDetails": { "title": "Open each lot page", "type": "boolean", "description": "Off by default. When on, each lot's own page is fetched to add its description, condition, cheapest shipping, full category path and seller type. It costs roughly 30 times more proxy traffic than the results grid alone, because the grid carries 30 lots per request and a lot page carries one.", "default": false }, "sellerType": { "title": "Seller type", "enum": [ "any", "private", "professional" ], "type": "string", "description": "Keep only private sellers or only professional (business) sellers, using the site's own registration sentence on the lot page. Requires 'Open each lot page' — the results grid publishes no seller information at all.", "default": "any" }, "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": 1000, "type": "integer", "description": "todocoleccion.net serves at most 1000 pages of 30 lots (30,000 lots) for any one query. Past page 999 it silently re-serves the same lots rather than returning an error. Clamped to that ceiling.", "default": 1000 } } }, "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 } } } } } } } } } }