# Milanuncios Scraper: Spain Classifieds & Cars (`getascraper/milanuncios-scraper`) Actor Scrape Spain's largest classifieds marketplace on Milanuncios.com. Extract cars, property, phones, and second-hand listings with full EUR prices, images, and seller profiles directly to Excel or JSON. Drop-in for CRM, Airtable, and RAG. Only $4.99 per 1,000 results. - **URL**: https://apify.com/getascraper/milanuncios-scraper.md - **Developed by:** [GetAScraper](https://apify.com/getascraper) (community) - **Categories:** E-commerce, Lead generation, Travel - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.99 / 1,000 scraped classified listings This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Milanuncios Scraper: Spain Classifieds & Cars **Get live Milanuncios listings: prices, mileage, and seller type, ready for your spreadsheet in under 60 seconds.** Get product titles, standardized prices, locations, vehicle specifications, and seller coordinates for any keyword across Spain. ![Milanuncios Scraper Spreadsheet Output](https://raw.githubusercontent.com/Devansh-365/actorstack/main/actors/milanuncios-scraper/assets/spreadsheet-output.png) --- ### What can you do with it? - **I am a car importer** comparing second-hand BMW or Audi prices across Spain to identify under-priced bargains for my dealership. - **I am a real estate investor** monitoring rental and sales apartments in Madrid and Barcelona to alert my clients of new direct-owner deals. - **I am a product reseller** building a price-drop tracker for hot consumer electronics (like iPhones or Playstations) to display on my local Shopify store. --- ### How to use it #### Store Quick Start 1. Create a free Apify account. 2. Open the **Milanuncios Scraper** in the Apify Store. 3. Enter your search keyword (e.g. `iphone 15` or `audi a4 avant`). 4. Select the target region or province (e.g., Madrid, Barcelona, Valencia). 5. Click **Start** and download the dataset as JSON, CSV, or Excel. #### API Quick Start For developers, you can trigger a run programmatically with a single request: ```bash curl --request POST \ --url "https://api.apify.com/v2/acts/getascraper~milanuncios-scraper/runs?token=YOUR_API_TOKEN" \ --header 'Content-Type: application/json' \ --data '{ "text": "audi q5", "maxItems": 100, "city": "madrid" }' ```` *** ### Input | Field | Type | Default | Description | | :------------ | :-------- | :---------- | :-------------------------------------------------------------------------------------------- | | `text` | `string` | `iphone 15` | Search keyword (e.g., `bmw x5` or `piso 3 habitaciones`). Supports Spanish and English terms. | | `city` | `string` | `all` | Filter listings by major Spanish regions or provinces (Madrid, Barcelona, Malaga). | | `category` | `string` | `""` | Target specific categories (Motor, Real Estate, Jobs, Phones, Fashion). | | `sellerType` | `string` | `""` | Filter for private direct owners (`private`) or professional dealerships (`professional`). | | `priceFrom` | `integer` | `0` | Minimum asking price in Euros. Set 0 for no limit. | | `priceTo` | `integer` | `0` | Maximum asking price in Euros. Set 0 for no limit. | | `isShippable` | `boolean` | `false` | Only include listings available for shipping (EnvΓ­os disponibles). | | `maxItems` | `integer` | `100` | Maximum number of listings to extract. | *** ### Output Each row represents a single listing from Milanuncios. ```json { "id": "578414171", "url": "https://www.milanuncios.com/bmw-de-segunda-mano/bmw-xm-578414171.htm", "title": "BMW - XM", "description": "Bienvenido a gtcars premium, presentes en gran canaria (las palmas y tablero)...", "postedDate": "2026-06-10T12:05:37.000Z", "scrapedAt": "2026-06-10T13:00:00.000Z", "price": 124900, "priceRaw": "124.900 €", "previousPrice": null, "currency": "EUR", "city": "San Miguel de Abona", "province": "Tenerife", "region": "Canarias", "address": "San Miguel de Abona (Tenerife)", "sellerType": "PROFESSIONAL", "sellerName": "GT Cars Premium Tenerife", "sellerSince": null, "sellerRating": null, "sellerTotalListings": null, "sellerUrl": "", "year": 2023, "mileage": 25800, "fuel": "Hybrid", "transmission": "Automatic", "hp": 653, "warranty": "12 Months", "images": [ "https://images.milanuncios.com/api/v1/ma-ad-media-pro/images/cfe40dfe-1781-4083-9ca0-eaecf5dc2e9b?rule=hw396_70" ] } ``` #### Field Reference | Field | Type | Description | | :------------- | :------- | :---------------------------------------------------------------------- | | `id` | `string` | Unique identifier of the listing. | | `url` | `string` | Direct public listing link. | | `title` | `string` | Title of the listing. | | `price` | `number` | Standardized current price value in Euros (EUR). | | `priceRaw` | `string` | Raw price string from the source (e.g., `124.900 €`). | | `province` | `string` | Spanish province where the listing is located (e.g., Madrid, Tenerife). | | `sellerType` | `string` | Type of seller (PROFESSIONAL or PRIVATE). | | `year` | `number` | Build year of the vehicle (Motor only). | | `mileage` | `number` | Mileage in kilometers (Motor only). | | `fuel` | `string` | Standardized fuel type (Diesel, Gasoline, Hybrid, Electric). | | `transmission` | `string` | Standardized transmission type (Automatic, Manual). | | `hp` | `number` | Horsepower rating of the vehicle. | | `warranty` | `string` | Standardized warranty period (e.g., `12 Months`). | | `images` | `array` | Thumbnail image URLs. | *** ### Pricing & Cost Pricing is pay-per-result and is billed per row successfully saved to your dataset. Empty runs cost absolutely nothing. - **Rate:** **$4.99 per 1,000 results** ($0.00499 per result). - **100 listings** typically cost **$0.50**. - **1,000 listings** cost exactly **$4.99**. - No fixed monthly subscriptions or hidden maintenance fees. *** ### Tips & Best Practices - **Bypass geoblocks natively.** The Actor automatically routes through premium, high-reputation Spanish (ES) Residential Proxies by default, ensuring seamless execution and 0% security blocks. - **Exclude dealers to find bargain deals.** Turn on the `sellerType: "private"` filter to drop professional dealerships and extract direct owner listings, saving you money on agency commissions. - **Schedule it.** Use Apify Schedules to run daily or weekly and watch for price drops or new listings entering your target region. *** ### FAQ ##### Does it get blocked by Milanuncios? No. The scraper natively routes through Spain (ES) Residential Proxies by default. This makes the bot traffic look identical to actual local Spanish users, bypassing Datadome security blocks cleanly. ##### Does it extract private seller phone numbers? No. Milanuncios protects private phone numbers behind a login wall and SMS verification. To protect user privacy and avoid verification blocks, the scraper retrieves full seller names, listings, and type classifications instead of phone numbers. ##### How fresh is the data? Extremely fresh. The scraper executes live browser rendering on every query, retrieving the absolute latest ads posted on the Milanuncios marketplace in real-time. ##### Are all categories supported? Yes. The scraper supports all major Milanuncios categories including Motor, Real Estate (Inmobiliaria), Jobs, Electronics, Phones, and Fashion. *** ### Target SEO Keywords - Milanuncios API - scrape Milanuncios - Spain classifieds scraper API - coches de segunda mano data - pisos de particulares Milanuncios - Milanuncios motor API *** ### Disclaimers & Support - **Disclaimer:** This Actor retrieves publicly available classified listings on Milanuncios. Make sure your usage complies with Milanuncios's terms of service and applicable laws. - **Support:** Open an issue from the Actor page in the Apify Console for bug reports or feature requests. # Actor input Schema ## `text` (type: `string`): Enter the product, car model, or listing keyword (e.g. 'Iphone 15', 'BMW X5', 'Piso 3 habitaciones'). Supports both Spanish and English terms. ## `city` (type: `string`): Filter listings by major Spanish regions/provinces. ## `category` (type: `string`): Select the vertical category. This helps apply category-specific normalization. ## `sellerType` (type: `string`): Filter out dealerships, agencies, or individual sellers. ## `isShippable` (type: `boolean`): If enabled, only return listings that can be shipped. ## `priceFrom` (type: `integer`): Minimum asking price in Euros. Set 0 for no limit. ## `priceTo` (type: `integer`): Maximum asking price in Euros. Set 0 for no limit. ## `yearFrom` (type: `integer`): Filter vehicles built in or after this year (e.g. 2018). Set 0 to ignore. ## `yearTo` (type: `integer`): Filter vehicles built in or before this year (e.g. 2023). Set 0 to ignore. ## `kmFrom` (type: `integer`): Filter vehicles with mileage equal to or greater than this value. Set 0 to ignore. ## `kmTo` (type: `integer`): Filter vehicles with mileage equal to or less than this value. Set 0 to ignore. ## `descriptionTruncateLength` (type: `integer`): Truncate full descriptions to the first N characters to save on storage and data size. Set 0 for full length. ## `maxItems` (type: `integer`): The maximum number of listing entries to extract. ## `proxyConfiguration` (type: `object`): Proxy settings. We pre-configure this to route through Spain (ES) Residential Proxies by default to ensure reliability. ## Actor input object example ```json { "text": "iphone 15", "city": "all", "category": "", "sellerType": "", "isShippable": false, "priceFrom": 0, "priceTo": 0, "yearFrom": 0, "yearTo": 0, "kmFrom": 0, "kmTo": 0, "descriptionTruncateLength": 0, "maxItems": 100, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "ES" } } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "text": "iphone 15", "city": "all", "category": "", "sellerType": "", "isShippable": false, "priceFrom": 0, "priceTo": 0, "yearFrom": 0, "yearTo": 0, "kmFrom": 0, "kmTo": 0, "descriptionTruncateLength": 0, "maxItems": 100, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "ES" } }; // Run the Actor and wait for it to finish const run = await client.actor("getascraper/milanuncios-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "text": "iphone 15", "city": "all", "category": "", "sellerType": "", "isShippable": False, "priceFrom": 0, "priceTo": 0, "yearFrom": 0, "yearTo": 0, "kmFrom": 0, "kmTo": 0, "descriptionTruncateLength": 0, "maxItems": 100, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "ES", }, } # Run the Actor and wait for it to finish run = client.actor("getascraper/milanuncios-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "text": "iphone 15", "city": "all", "category": "", "sellerType": "", "isShippable": false, "priceFrom": 0, "priceTo": 0, "yearFrom": 0, "yearTo": 0, "kmFrom": 0, "kmTo": 0, "descriptionTruncateLength": 0, "maxItems": 100, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "ES" } }' | apify call getascraper/milanuncios-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=getascraper/milanuncios-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Milanuncios Scraper: Spain Classifieds & Cars", "description": "Scrape Spain's largest classifieds marketplace on Milanuncios.com. Extract cars, property, phones, and second-hand listings with full EUR prices, images, and seller profiles directly to Excel or JSON. Drop-in for CRM, Airtable, and RAG. Only $4.99 per 1,000 results.", "version": "0.1", "x-build-id": "jNKFJmqNFwTeTvGzU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~milanuncios-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-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/getascraper~milanuncios-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-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/getascraper~milanuncios-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-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", "required": [ "text" ], "properties": { "text": { "title": "Search Keyword", "type": "string", "description": "Enter the product, car model, or listing keyword (e.g. 'Iphone 15', 'BMW X5', 'Piso 3 habitaciones'). Supports both Spanish and English terms.", "default": "iphone 15" }, "city": { "title": "Region / Province", "enum": [ "all", "madrid", "barcelona", "valencia", "sevilla", "malaga", "zaragoza", "alicante", "murcia", "vizcaya", "baleares", "canarias" ], "type": "string", "description": "Filter listings by major Spanish regions/provinces.", "default": "all" }, "category": { "title": "Market Vertical", "enum": [ "", "1", "32", "3", "2", "83", "43" ], "type": "string", "description": "Select the vertical category. This helps apply category-specific normalization.", "default": "" }, "sellerType": { "title": "Seller Classification", "enum": [ "", "private", "professional" ], "type": "string", "description": "Filter out dealerships, agencies, or individual sellers.", "default": "" }, "isShippable": { "title": "Available for Shipping", "type": "boolean", "description": "If enabled, only return listings that can be shipped.", "default": false }, "priceFrom": { "title": "Minimum Price (EUR)", "type": "integer", "description": "Minimum asking price in Euros. Set 0 for no limit.", "default": 0 }, "priceTo": { "title": "Maximum Price (EUR)", "type": "integer", "description": "Maximum asking price in Euros. Set 0 for no limit.", "default": 0 }, "yearFrom": { "title": "Minimum Year (Motor Only)", "type": "integer", "description": "Filter vehicles built in or after this year (e.g. 2018). Set 0 to ignore.", "default": 0 }, "yearTo": { "title": "Maximum Year (Motor Only)", "type": "integer", "description": "Filter vehicles built in or before this year (e.g. 2023). Set 0 to ignore.", "default": 0 }, "kmFrom": { "title": "Minimum Mileage (kms) (Motor Only)", "type": "integer", "description": "Filter vehicles with mileage equal to or greater than this value. Set 0 to ignore.", "default": 0 }, "kmTo": { "title": "Maximum Mileage (kms) (Motor Only)", "type": "integer", "description": "Filter vehicles with mileage equal to or less than this value. Set 0 to ignore.", "default": 0 }, "descriptionTruncateLength": { "title": "Description Truncation Limit", "type": "integer", "description": "Truncate full descriptions to the first N characters to save on storage and data size. Set 0 for full length.", "default": 0 }, "maxItems": { "title": "Max Listings (Total)", "minimum": 1, "type": "integer", "description": "The maximum number of listing entries to extract.", "default": 100 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. We pre-configure this to route through Spain (ES) Residential Proxies by default to ensure reliability.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "ES" } } } }, "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 } } } } } } } } } } ```