{ "openapi": "3.0.1", "info": { "title": "Milanuncios Scraper - Spain Classifieds API", "description": "Scrape listings from Milanuncios, Spain's classifieds site. Each row has the listing id, title, price in EUR, category, province and city. You also get description, photos and the URL. It says if the seller is private or professional. Cars, property, phones, jobs. $1.00 per 1,000 listings.", "version": "0.1", "x-build-id": "I30Hd9iJ9mnmTCU41" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dami_studio~milanuncios-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dami_studio-milanuncios-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/dami_studio~milanuncios-scraper/runs": { "post": { "operationId": "runs-sync-dami_studio-milanuncios-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/dami_studio~milanuncios-scraper/run-sync": { "post": { "operationId": "run-sync-dami_studio-milanuncios-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", "properties": { "query": { "title": "Search terms", "type": "string", "description": "What to search for, in Spanish - for example \"sofa cama\", \"iphone 15\", \"piso alquiler\". Leave empty to browse a whole category." }, "searchUrls": { "title": "Milanuncios search URLs", "type": "array", "description": "Optional. Paste Milanuncios search or category URLs instead of filling in the fields above, e.g. https://www.milanuncios.com/coches-de-segunda-mano/?desde=5000&vendedor=part. The category, search text, price range, seller type and order in the URL are all read.", "items": { "type": "string" } }, "provinces": { "title": "Provinces", "type": "array", "description": "Optional. Restrict to one or more Spanish provinces by name (\"Madrid\", \"Barcelona\", \"A Coruña\", \"Valencia\") or INE code 1-52. Milanuncios' own province filter also returns neighbouring provinces, so this actor filters the results exactly - listings outside your provinces are dropped and never charged.", "items": { "type": "string" } }, "sellerType": { "title": "Seller type", "enum": [ "any", "private", "professional" ], "type": "string", "description": "Return only private sellers (particulares) or only professional sellers (dealers, agencies, shops).", "default": "any" }, "transaction": { "title": "Offers or wanted ads", "enum": [ "supply", "demand" ], "type": "string", "description": "Milanuncios carries both offers (someone selling) and wanted ads (someone looking to buy).", "default": "supply" }, "category": { "title": "Category", "type": "array", "description": "Optional. Milanuncios category by name, slug or id. Sections: Motor, Inmobiliaria, Empleo, Telefonía, Informática, Casa y Jardín, Moda y complementos, Deportes y náutica, Mascotas y agricultura, Aficiones y ocio, Imagen y Sonido, Juegos, Bebés, Formación y libros, Servicios, Negocios, Comunidad. Sub-categories work too (Coches, Motos, Furgonetas, Viviendas, Móviles, Portátiles). 2302 categories are recognised.", "items": { "type": "string" } }, "sort": { "title": "Sort order", "enum": [ "relevance", "newest", "cheap", "expensive", "oldest" ], "type": "string", "description": "Newest first and Oldest first only work inside the Motor section - Milanuncios returns nothing for them in other categories, so the actor falls back to Most relevant and says so in the log.", "default": "relevance" }, "minPrice": { "title": "Minimum price (EUR)", "minimum": 0, "type": "integer", "description": "Optional lower price bound." }, "maxItems": { "title": "Maximum listings", "minimum": 1, "maximum": 50000, "type": "integer", "description": "How many listings to return in total across all searches. Each returned listing is one charged result. Milanuncios caps any single search at 8300 results; add provinces, price bands or sub-categories to go past that.", "default": 100 }, "maxPrice": { "title": "Maximum price (EUR)", "minimum": 0, "type": "integer", "description": "Optional upper price bound." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. This actor does not need a proxy - Milanuncios' search API answers the Apify container directly, which is why it is cheap. Supply your own proxy only if you want the traffic routed somewhere specific.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }