Milanuncios Scraper — Spain Classified Ads, Prices & Sellers

Spain's biggest classifieds site in rows: price in euros, full description, city, province and region, the private-versus-professional seller split, and whether the ad is an offer or a wanted request.

What does the Milanuncios Scraper do?

This Actor collects live ads from Milanuncios.com, the general classifieds site Spain uses for cars, property, electronics, services and everything in between. Each result page ships its ads inside a JSON payload that the site's own front end renders from, so this Actor reads structured records rather than parsing markup — which is why the seller type, the full category path and the per-category attribute tags are all available without opening a single detail page.

Browse one of 18 top-level categories or search by keyword across the whole site, optionally narrowed to a province, and the Actor pages through roughly 41 ads per page. One detail is worth knowing: the province belongs in the URL path, not in a query parameter. Passed as a parameter it is accepted and then ignored, and a run comes back full of ads from the wrong end of the country. This Actor builds the path form, so a Madrid filter really does return Madrid.

Who is it for?

• Resellers and arbitrage traders scanning Spanish second-hand supply for under-priced stock.
• Automotive and property analysts — Milanuncios is one of Spain's largest car and property listing pools.
• Lead-generation teams using the professional-seller flag and seller IDs to map dealers.
• Market researchers tracking Spanish resale prices region by region.
• Marketplace operators benchmarking supply, pricing and listing quality in Spain.

Use cases

• Compare asking prices for the same category between Madrid, Barcelona and Valencia.
• Split a category by seller type to size how much of the supply is professional.
• Collect wanted ads specifically — the adDirection field separates demand from supply, which most datasets cannot.
• Track how long ads stay live by diffing publishDate against daily runs.
• Build a dealer list from sellerId, sellerName and the professional flag.
• Feed an AI agent live Spanish classifieds prices for valuation questions.

Why use this Milanuncios Scraper?

• Offer versus wanted on every row — a demand signal most classifieds datasets throw away.
• Private versus professional seller flag, plus the seller ID and display name.
• Province filtering that actually filters — built as a URL path, not the query parameter the site silently ignores.
• Full category path, e.g. Motor > Coches > Mercedes-Benz, not just a leaf label.
• Attribute tags per category — mileage, year and fuel for cars; size and rooms for property.
• Keyless and login-free — nothing to register, nothing to rotate.

What data can you extract?

One row per ad. Anything the source left blank comes back as null.

Field	Type	Description
adId	string	Milanuncios ad identifier
url	string	Direct link to the ad
title	string	Ad title
description	string	Full ad description
price	number	Asking price in euros
category	string	Leaf category of the ad
categoryPath	string	Full category path from section to leaf
city	string	City or town
province	string	Province
region	string	Autonomous community
sellerType	string	private or professional
isProfessional	boolean	True where the seller is a business
sellerId	number	Milanuncios user ID
sellerName	string	Seller's public display name
isContactable	boolean	Seller accepts contact through the site
adDirection	string	offered for a sale ad, wanted for a demand ad
isNew	boolean	Item advertised as new
isReserved	boolean	Ad marked reserved
isHighlighted	boolean	Paid highlighted placement
attributes	string	Category attribute tags, e.g. "kilómetros: 109.000 kms
publishDate	string	When the ad was first published
updatedDate	string	When it was last bumped or updated
imageCount	number	Number of photos
imageUrl	string	First photo
scrapedAt	string	When this row was collected

Sample output

{
  "adId": "495968332",
  "url": "https://www.milanuncios.com/casas-prefabricadas-en-cadiz-cadiz/transformacion-contenedor-maritimo-495968332...",
  "title": "TRANSFORMACION CONTENEDOR MARITIMO",
  "description": "Vendemos oficina, viviendas, bares, piscina a partir de la transformación de contenedores marítimos , tanto...",
  "price": 1,
  "category": "Casas prefabricadas",
  "categoryPath": "Inmobiliaria > Viviendas > Casas prefabricadas",
  "city": "Cádiz",
  "province": "Cádiz",
  "region": "Andalucía",
  "sellerType": "professional",
  "isProfessional": true,
  "sellerId": 226938569,
  "sellerName": "comercial: Global Container",
  "isContactable": false,
  "adDirection": "offered",
  "isNew": false,
  "isReserved": false,
  "isHighlighted": false,
  "attributes": null,
  "publishDate": "2023-10-03T21:41:49Z",
  "updatedDate": "2026-08-14T05:37:44Z",
  "imageCount": 9,
  "imageUrl": "https://images.milanuncios.com/api/v1/ma-ad-media-pro/images/4b4b81f0-ca89-422a-bafb-19d9a3410cb4",
  "scrapedAt": "2026-08-15T08:03:39.643Z"
}

How to use the Milanuncios Scraper

Option A — a whole category

Pick a section such as motor, property, phones or home & garden, leave the keyword empty and set a result limit. Roughly 41 ads arrive per page.

Option B — a keyword across the site

Enter a search term such as iphone or piso alquiler. A keyword search runs across all categories, so the category selection is ignored in this mode.

Option C — one province

Add a province as it appears in a Milanuncios URL — madrid, barcelona, valencia, sevilla, malaga — with either of the modes above. National ads from relocatable sellers still appear, which is how the site itself behaves.

Input parameters

Input	Type	Description
category	string	Milanuncios section to browse. Ignored when a keyword is given, since a keyword search runs across the whole site. Default: "motor".
keyword	string	Optional search term, e.g. iphone, bicicleta, piso alquiler. When set, the search runs across all categories.
province	string	Optional Spanish province, written as it appears in a Milanuncios URL: madrid, barcelona, valencia, sevilla, malaga, alicante, murcia, zaragoza. Leave empty for all of Spain.
maxResults	integer	Stop after this many ads. Each page returns about 41. Milanuncios caps one search at 10,000 ads, so narrow by category, keyword or province to reach beyond that. Default: 500.
proxyConfiguration	object	Milanuncios serves Spanish exits. Residential proxy pinned to Spain is used automatically.

Tips for best results

• A single search stops at 10,000 ads. Split by category, province or keyword to go deeper rather than raising the limit.
• adDirection is worth filtering on: a category browse mixes sellers and buyers, and wanted ads distort a price analysis if left in.
• updatedDate moves when a seller bumps an ad, while publishDate does not — the gap between them shows how long something has been unsold.
• Professional sellers dominate some categories entirely; check the seller-type split before treating a category as a consumer market.
• Attribute tags differ per category, so parse them per category rather than expecting one shape across a mixed run.

Integrations

Connect this Actor to Make, Zapier, n8n, Slack, Google Sheets, GitHub, Airtable or any HTTP endpoint through Apify integrations. Every finished run can push its dataset straight into your warehouse, or fire a webhook so a downstream job starts the moment the data lands.

API usage

Run the Actor from your own code with the Apify API. Datasets can be exported as JSON, CSV, Excel, XML, RSS or HTML, and every run is available through the Apify API reference.

curl -X POST "https://api.apify.com/v2/acts/logiover~milanuncios-spain-classifieds-scraper/runs?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"input": {"category": "motor", "keyword": "", "province": "madrid", "maxResults": 1000, "proxyConfiguration": {"useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "ES"}}}'

Python, JavaScript, PHP and CLI clients are documented under Apify API clients.

Use with AI agents (MCP)

This Actor is callable from any MCP-compatible client — Claude, Cursor, VS Code or your own agent — through the Apify MCP server. An agent can call it to answer live questions about Spanish classified ad prices, regional supply and dealer versus private listings instead of guessing from stale training data.

FAQ

Do I need a Milanuncios account or API key?

No. The Actor reads public ads with no login and no key.

Why does a province filter often fail on Milanuncios?

Because the site accepts a provincias= parameter and then ignores it — results come back nationwide with no error. The province has to be part of the URL path, which is what this Actor builds.

How many ads can one run return?

A category typically reports 10,000 reachable ads across 200 pages. Splitting by province or keyword multiplies what a run can reach.

What is the difference between an offer and a wanted ad?

adDirection is offered when someone is selling and wanted when they are looking to buy. Milanuncios carries a lot of both.

Can I get the seller's phone number?

No. Milanuncios keeps contact behind its own flow. The Actor collects the seller ID, display name, seller type and whether the seller accepts contact.

Which categories are supported?

18 top-level sections including motor, used cars, property, jobs, training, services, business, computing, image & sound, phones, games, home & garden, fashion, baby, hobbies, sport & boating, pets and community.

Why did my run return zero ads?

Usually a province spelled differently from the Milanuncios URL. Use madrid, not Madrid or comunidad-de-madrid.

Is the data in Spanish?

Yes. Titles, descriptions, categories and attribute tags are published in Spanish and collected as written.

Can I export to CSV or Excel?

Yes. Every run's dataset exports as JSON, CSV, Excel, XML, RSS or HTML from the Storage tab, the API, or automatically through an integration.

How fresh is the data?

Every run reads the site live at that moment, so the data is as fresh as the site itself. Schedule the Actor hourly, daily or weekly to build a time series.

How often is the Actor updated?

It is monitored and fixed when the site changes its markup or its endpoints. Report anything that looks wrong through the Issues tab and it gets picked up.

Is it legal to scrape Milanuncios?

This Actor collects only publicly available information — the same pages any visitor can open without logging in. It does not bypass a login, and it does not touch private or personal accounts. Public data collection is legal in most jurisdictions, but how you use the data is your responsibility: if any record contains personal data, GDPR and comparable laws still apply, and you need a lawful basis for processing it. When in doubt, take legal advice. See Apify's ethical web scraping guide.

Related scrapers

• Coches.net Scraper — Spanish used cars with dealer phone numbers.
• Pisos.com Scraper — Spanish property listings.
• Habitaclia Scraper — Catalan and Spanish property.
• Kleinanzeigen Scraper — German classifieds.
• Subito.it Scraper — Italian classifieds.