Milanuncios Scraper | Real-Time Data API (2026)

Extract listing data from Milanuncios, Spain's largest classifieds marketplace with 10+ million monthly visitors. Get full details including photos, seller profiles, pricing history, statistics, and shipping options.

Milanuncios covers cars, motorcycles, phones, electronics, real estate, jobs, and more. This scraper handles pagination, deduplication, and parallel detail fetching automatically.

---

Para usuarios de habla hispana: Extrae datos de anuncios de Milanuncios, el mayor portal de clasificados de España. Obtiene todos los detalles: fotos, información del vendedor, historial de precios, estadísticas y opciones de envío. Compatible con todas las categorías: Motor, Inmobiliaria, Informática, Telefonía, y más.

---

Rental Pricing

$29 per month: Unlimited listings, unlimited runs.

• Extract unlimited items per month
• Run as many times as needed
• All categories and filters included
• Full seller and shop profiles
• Cancel anytime

Ideal for market researchers, resellers, and businesses monitoring Spanish classifieds.

Quick Start

Basic Search

{
    "text": "iphone 15",
    "maxResults": 100
}

Category Filter

{
    "category": "1",
    "sort": "newest",
    "maxResults": 500
}

Advanced Filtering

{
    "text": "bmw x5",
    "category": "1",
    "sellerType": "professional",
    "priceFrom": 15000,
    "priceTo": 40000,
    "sort": "cheap",
    "maxResults": 200
}

Input Parameters

Parameter	Type	Default	Description
text	String	-	Search query (e.g., "iphone 15", "bmw x5")
category	Integer	-	Category ID to filter results
sort	String	relevance	Sort order: relevance, newest, cheap, expensive
sellerType	String	-	Filter: professional or private
transaction	String	-	Filter: supply (for sale) or demand (wanted)
priceFrom	Integer	-	Minimum price in EUR
priceTo	Integer	-	Maximum price in EUR
isShippable	Boolean	false	Only include shippable items
maxResults	Integer	0	Maximum listings to extract (0 = unlimited)

Category IDs

ID	Category	Description
1	Motor	All vehicles
32	Inmobiliaria	Real estate
3	Empleo	Jobs
2	Informática	IT and Electronics
83	Telefonía	Phones and accessories
39	Juegos	Games
30	Casa y Jardín	Home and Garden
43	Moda	Fashion and accessories
31	Deportes	Sports and nautical

Use category: "" (empty) for all categories.

Output

Each listing includes 35+ fields organized by category.

Core Fields

• id - Unique listing identifier
• title - Listing title
• description - Full description text
• url - Listing URL path on Milanuncios

Pricing

• price - Current price object with value (integer) and label (formatted string)
• previousPrice - Previous price if item was reduced

Location

• location - Object containing:
  • city - City name, ID, and slug
  • province - Province name, ID, and slug
  • region - Region name, ID, and slug

Seller Information

• authorId - Seller's user ID
• authorName - Seller's display name
• author - Detailed seller profile:
  • memberSince - Account creation date
  • rating - Rating object with badges and reputation
  • location - Seller's location with lat/long coordinates
  • sellerType - PROFESSIONAL or PRIVATE

Shop (Professional Sellers)

• shop - Business information:
  • name - Business name
  • address - Street address
  • locality - City/town
  • province - Province
  • zipcode - Postal code
  • storeId - Shop ID
  • url - Shop profile URL

Media

• photos - Array of full-resolution image URLs

Statistics

• stats - Engagement metrics:
  • views - Total views
  • favorites - Times favorited
  • shares - Times shared
  • listings - Seller's total listings count

Attributes

• attributes - Object keyed by attribute name, each with raw and formatted values:
  • Vehicles: kilometers, year, fuel, transmission, hp, doors, color, warranty
  • Phones: storage, condition, brand
  • Other categories: varies by listing type

Shipping

• shipping - Shipping availability
• carriers - Available carriers with prices
• isShippable* - Various shipping option flags

Metadata

• categories - Category hierarchy array
• publicationDate - Original listing date
• updateDate - Last update date
• scrapedAt - Extraction timestamp

Output Example

{
  "attributes": {
    "kilometers": {
      "raw": "25800",
      "formatted": "25.800 kms"
    },
    "year": {
      "raw": "2023",
      "formatted": "2023"
    },
    "fuel": {
      "raw": "other",
      "formatted": "otro"
    },
    "transmission": {
      "raw": "automatic",
      "formatted": "automático"
    },
    "hp": {
      "raw": "653",
      "formatted": "653 CV"
    },
    "doors": {
      "raw": "5",
      "formatted": "5 puertas"
    },
    "color": {
      "raw": "azul",
      "formatted": "azul"
    },
    "warranty": {
      "raw": "12 meses (1 año)",
      "formatted": "12 meses (1 año)"
    }
  },
  "authorId": "207754224",
  "authorName": "GT Cars Premium Tene",
  "categories": [
    {
      "id": 1,
      "name": "Motor",
      "slug": "motor"
    },
    {
      "id": 13,
      "name": "Coches",
      "slug": "coches-de-segunda-mano"
    },
    {
      "id": 805,
      "name": "BMW",
      "slug": "bmw-de-segunda-mano"
    }
  ],
  "contactMethods": {
    "chat": false,
    "form": true,
    "phone": true
  },
  "description": "Bienvenido a gtcars premium, presentes en gran canaria (las palmas y tablero) y tenerife (las chafiras).\n\nentregamos vehículos en cualquiera de las islas. somos un concesionario con más de 20 años de experiencia, dando el mejor servicio al cliente y a su vehículo.\n\ndescubra uno de los mayores stocks de vehículos premium y lujo de canarias.\n\nen gtcars elegimos solo las mejores selecciones de stock procedente de las principales marcas. si no encuentra su vehículo ideal, se lo buscamos, vehículos cuidados, revisados y acondicionados con bajo kilometraje y garantías. consulte condiciones.\n\nla confianza, el secreto de nuestro exito.\n\ntodo incluido: preparación, gestión de documentación, financiación y garantía oficial.\n\ntodos nuestros vehículos pasan un estricto control de calidad siguiendo nuestros estándares.\n\nadmitimos todo tipo de vehículos como parte de pago. llámenos y tasaremos su vehículo sin compromiso.\n\ncondiciones de financiación desde 24 hasta 120 meses.\n\ncontáctenos y le enviaremos una propuesta personalizada adaptada a sus necesidades.\n\nanuncio informativo, no vinculante, sin validez contractual, sujeto a posibles errores y disponibilidad.",
  "distance": null,
  "extras": [],
  "id": "578414171",
  "isHighlighted": true,
  "isNew": false,
  "location": {
    "city": {
      "id": 54264,
      "name": "San Miguel de Abona",
      "slug": "san-miguel-de-abona"
    },
    "geolocation": null,
    "province": {
      "id": 38,
      "name": "Tenerife",
      "slug": "tenerife"
    },
    "region": {
      "id": 62,
      "name": "Canarias",
      "slug": "canarias"
    }
  },
  "origin": {
    "name": "inner",
    "provider": "was"
  },
  "previousPrice": null,
  "price": {
    "cash": {
      "includeTaxes": true,
      "label": "124.900 €",
      "value": 124900
    },
    "financed": {
      "label": "124.900 €",
      "value": 124900
    }
  },
  "publicationDate": "2026-01-28T12:05:37Z",
  "shipping": null,
  "sortDate": "2026-02-02T10:04:53Z",
  "title": "BMW - XM",
  "transaction": "supply",
  "type": "professional",
  "updateDate": "2026-02-02T09:06:33Z",
  "url": "/bmw-de-segunda-mano/bmw-xm-578414171.htm",
  "visibility": "normal",
  "scrapedAt": "2026-02-02T09:52:28.762592+00:00",
  "scrapedAtTimestamp": 1770025948,
  "author": {
    "id": "207754224",
    "isEmailVerified": true,
    "location": {
      "city": "san miguel de abona",
      "lat": 28.024078,
      "long": -16.624159,
      "province": "tenerife"
    },
    "memberSince": "2020-08-06T10:59:59.195Z",
    "name": "Anónimo",
    "rating": {
      "_links": {
        "self": {
          "href": "https://localhost/profile/sdrn%3Amilanuncios%3Auser%3A207754224"
        }
      },
      "badges": [],
      "communication": {
        "repliedConversations": null,
        "replyRateText": null,
        "replyTimeInMinutes": null,
        "replyTimeText": null,
        "totalConversations": null
      },
      "identity": {
        "avatar": null,
        "description": null,
        "isVerified": false,
        "localProfileId": null,
        "memberSince": null,
        "municipality": null,
        "name": null,
        "region": null
      },
      "presence": {
        "enabled": true,
        "lastActivity": null,
        "presenceText": null,
        "status": "OFFLINE"
      },
      "replyTimeText": null,
      "reputation": {
        "feedback": null
      },
      "sdrnId": {
        "id": "207754224",
        "tenant": "MILANUNCIOS"
      }
    },
    "sellerType": "PROFESSIONAL"
  },
  "photos": [
    "https://images.milanuncios.com/api/v1/ma-ad-media-pro/images/327b7ea8-5aa9-481d-b058-40409df6b9e6",
    "https://images.milanuncios.com/api/v1/ma-ad-media-pro/images/9ab45513-a9a1-4294-9e1c-688848759a1b",
    "https://images.milanuncios.com/api/v1/ma-ad-media-pro/images/35c64c01-b5ed-41e7-8703-8435dc331186",
    "https://images.milanuncios.com/api/v1/ma-ad-media-pro/images/2ee3c59b-71d1-4b9f-a38e-bb0a1e73a027",
    "https://images.milanuncios.com/api/v1/ma-ad-media-pro/images/300cc854-a825-471a-8336-6a533bbacf67",
    "https://images.milanuncios.com/api/v1/ma-ad-media-pro/images/1975a302-704b-489f-8802-b77db5043850",
    "https://images.milanuncios.com/api/v1/ma-ad-media-pro/images/0964e569-1778-495a-b608-d3afb68b89d2",
    "https://images.milanuncios.com/api/v1/ma-ad-media-pro/images/54400a4b-0960-42e7-bdf7-a239014d778a",
    "https://images.milanuncios.com/api/v1/ma-ad-media-pro/images/27c4a2ed-b402-4fc1-9155-66ce65ee795e",
    "https://images.milanuncios.com/api/v1/ma-ad-media-pro/images/71c154a4-943f-493e-9d34-fbf4df5f0c71",
    "https://images.milanuncios.com/api/v1/ma-ad-media-pro/images/1336cfa4-2fd0-40a6-93f9-2fa271a6173d",
    "https://images.milanuncios.com/api/v1/ma-ad-media-pro/images/cff80ad2-2f24-4afa-abb5-c25cc8c05454",
    "https://images.milanuncios.com/api/v1/ma-ad-media-pro/images/c39c6d79-4845-4ab9-b01e-d5cbd9e27cde",
    "https://images.milanuncios.com/api/v1/ma-ad-media-pro/images/fbbb2dc0-f820-458f-886f-08e077764a8a",
    "https://images.milanuncios.com/api/v1/ma-ad-media-pro/images/3b42ecb7-af0a-42ab-a0a0-375825bcc85d",
    "https://images.milanuncios.com/api/v1/ma-ad-media-pro/images/4c774465-6b42-4b7b-9620-61408b692ac8",
    "https://images.milanuncios.com/api/v1/ma-ad-media-pro/images/4a3dea6a-8fdb-441b-a99c-bdf5f7ea6e40",
    "https://images.milanuncios.com/api/v1/ma-ad-media-pro/images/5892bc57-5061-48cb-b009-ebaff6ef8b49"
  ],
  "stats": {
    "autoRenewals": 0,
    "emailsSent": 0,
    "favorites": 0,
    "listings": 75,
    "phoneViews": 0,
    "shares": 1,
    "views": 0
  },
  "carriers": [],
  "reserve": {
    "isReserved": false,
    "status": "RELEASED"
  },
  "sellerId": "",
  "shop": {
    "address": "Avenida ten bel nº12 las chafiras",
    "description": null,
    "hasShopProfile": false,
    "locality": "Archile",
    "logoUrl": null,
    "name": "GT Cars Premium Tenerife",
    "province": "Tenerife",
    "storeId": "225380",
    "url": "/tiendas-profesionales/gt-cars-premium-tenerife-225380",
    "zipcode": "38639"
  },
  "packageWeight": "NONE",
  "isShippableContentSharing": false,
  "isShippableExternalCheckout": false,
  "isShippableMaExpress": false
}

Key Features

Data Extraction

• Full listing details: Title, description, price, photos, attributes
• Seller profiles: Name, member since, rating, badges, location with coordinates
• Shop information: Business name, address, store URL for professional sellers
• Price tracking: Current price and previous price (for reduced items)
• Statistics: Views, favorites, shares count per listing

Search and Filtering

• Keyword search: Find listings by text query
• Category filter: Target specific categories (cars, phones, electronics)
• Price range: Set minimum and maximum price in EUR
• Seller type: Filter by professional or private sellers
• Transaction type: For sale (supply) or wanted (demand)
• Shipping filter: Only items available for shipping

Performance

• Parallel processing: Fetches multiple listing details simultaneously
• Automatic pagination: Handles large result sets seamlessly
• Deduplication: No duplicate listings in output
• Rate limit handling: Built-in retry logic with backoff

Use Cases

For Market Researchers

• Track pricing trends: Monitor price changes across categories
• Analyze seller competition: Compare professional vs private sellers
• Study regional markets: Filter by location and province
• Measure listing velocity: Track publication dates and updates

For Resellers and Dealers

• Find underpriced items: Sort by price, filter by category
• Source inventory: Extract professional seller listings
• Monitor competitors: Track specific sellers or shops
• Identify opportunities: Filter by recent listings

For Data Analysts

• Build datasets: Export structured JSON for analysis
• Create dashboards: Track market metrics over time
• Generate reports: Aggregate data by category, region, seller type
• Feed ML models: Use listing data for price prediction

API Integration

Python

from apify_client import ApifyClient

client = ApifyClient("your_api_token")

run_input = {
    "text": "iphone 15",
    "category": 83,
    "priceTo": 500,
    "sort": "cheap",
    "maxResults": 100
}

run = client.actor("zen-studio/milanuncios-scraper").call(run_input=run_input)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"{item['title']} - {item['price']['cash']['label']}")

JavaScript

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'your_api_token' });

const run = await client.actor('zen-studio/milanuncios-scraper').call({
    text: 'iphone 15',
    category: 83,
    priceTo: 500,
    sort: 'cheap',
    maxResults: 100
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach(item => {
    console.log(`${item.title} - ${item.price.cash.label}`);
});

Advanced Usage

Monitor Price Drops

Extract listings with previous prices to find recently reduced items:

{
    "category": "1",
    "sort": "newest",
    "maxResults": 1000
}

Then filter results where previousPrice exists.

Professional Dealer Inventory

Get all listings from professional sellers in a category:

{
    "category": "1",
    "sellerType": "professional",
    "transaction": "supply",
    "sort": "newest"
}

Budget Shopping

Find cheapest items in a category with shipping available:

{
    "text": "playstation 5",
    "isShippable": true,
    "sort": "cheap",
    "maxResults": 50
}

Regional Market Analysis

Combine with location data in output to analyze regional pricing:

{
    "category": "1",
    "priceFrom": 5000,
    "priceTo": 20000,
    "maxResults": 5000
}

Group results by location.province.name for regional comparison.

Car Hunter — Buscador de Coches

Search for specific models with budget and seller filters:

{
    "text": "audi a4 avant",
    "category": "1",
    "priceFrom": 8000,
    "priceTo": 25000,
    "sellerType": "professional",
    "sort": "newest",
    "maxResults": 200
}

Post-filter results by attributes.kilometers.raw and attributes.year.raw for mileage/age criteria.

Real Estate Hunter — Buscador de Pisos

Monitor new apartment listings in your price range:

{
    "text": "piso 3 habitaciones",
    "category": "32",
    "priceFrom": 100000,
    "priceTo": 250000,
    "sort": "newest",
    "maxResults": 500
}

Group by location.province.name for regional comparison. Check type field for agency (professional) vs owner (private).

Data Export

Export your data in multiple formats:

• JSON: Full structured data for programmatic use
• CSV: Spreadsheet-compatible for analysis
• Excel: Ready for pivot tables and charts

Access exports from the Apify Console dataset view or via API.

Scheduling

Set up automated runs:

• Hourly: Track fast-moving categories
• Daily: Monitor market trends
• Weekly: Generate periodic reports

Configure schedules in the Apify Console under Schedules.

FAQ

What data can I extract?

Full listing details including title, description, price, photos, seller information, shop details, statistics, attributes, categories, and timestamps. See Output section for complete field list.

How many listings can I extract?

Unlimited. Set maxResults to 0 or leave empty. The scraper handles pagination automatically.

Do I need a Milanuncios account?

No. The scraper extracts publicly available data without requiring login.

How fresh is the data?

Data is extracted in real-time. Each run fetches current listing information directly from Milanuncios.

What categories are supported?

All Milanuncios categories: Motor (cars, motorcycles), Electronics, Phones, Real Estate, Jobs, Services, and more.

How long does extraction take?

Depends on the number of listings. Expect roughly 1000-2000 listings per minute with detail fetching.

Can I filter by location?

Location filtering is not available as an input parameter, but output includes full location data (city, province, region) for post-processing.

Is the data structured consistently?

Yes. All listings follow the same schema. Some fields may be null if not applicable to the listing type.

---

Start Extracting Milanuncios Data

---

Get structured data from Spain's largest classifieds marketplace.