{ "openapi": "3.0.0", "info": { "version": "1.0", "title": "Milanuncios API", "description": "Milanuncios API for Spain classifieds data: anuncios clasificados and segunda mano listings for coches de segunda mano, used cars and motorbikes, pisos, flats and houses for sale and rent, electronics, mobile phones, home goods, jobs and services. Search listings with category filters, get listing details with photos, seller and dealer or agency store profiles, price drops, shipping quotes, seller phone numbers and Spain geocoding. Build Spain classifieds apps, used car and real estate portals and price tracking tools similar to Wallapop, Idealista, Fotocasa, Coches.net and Autocasion.", "x-category": "Data", "x-long-description": "# 🇪🇸 Milanuncios API\n\n| Feature | Details |\n| --- | --- |\n| **Last Updated** | **October 11, 2026** |\n| 🇪🇸 Market Coverage | Spain: classifieds from every province, region and city on Milanuncios, as listed on the site |\n| 🗂️ Categories Carried | Cars and used cars, motorbikes, real estate (pisos, houses, rooms), electronics, mobile phones, home goods, jobs, services and the rest of the Milanuncios category tree, with each category's own filter definitions |\n| 🔍 Search Filters | `searchListings`: 58 filters, including keyword, category, province, city and neighbourhood zone, coordinates with radius, price range, seller type, condition, car make, model, year, mileage, fuel, transmission, surface, bedrooms and bathrooms, plus 10 sort orders |\n| 🔗 URL Front Doors | Paste a milanuncios.com search or category address and get its listings with the filters applied, or paste a listing address and get the full listing record |\n| 🖼️ Listing Detail | Full photo gallery, specifications, description, seller, store, view and favourite statistics, financing offers and the price rating on cars |\n| 📉 Price Drops | Reduced listings only, each with the previous price and the amount and percentage of the drop |\n| 🧮 Category Breakdown | How the matches of a keyword search split across the child categories |\n| 🚚 Shipping Quotes | Shipping methods and the full buyer cost for shippable listings |\n| 🏪 Seller and Store Profiles | Seller profile with trust badge and sales, plus dealer and agency store profiles and their full inventory |\n| 📞 Seller Phone Numbers | The phone numbers of listings that show phone contact |\n| 📍 Zones and Geocoding | Province, city and neighbourhood zone ids, street address autocomplete, geocoding and reverse geocoding for Spain |\n| ⚡ API Type | Fast REST API via RapidAPI |\n\nBring Spain classifieds data from Milanuncios (milanuncios.com) into your application: search coches de segunda mano, motorbikes, pisos for sale and for rent, electronics, mobile phones, home goods, jobs and services with a full filter set, open any listing with its photos, specifications and seller, track price drops, quote shipping, follow dealers and agencies to their whole inventory and geocode places in Spain.\n\n## Overview\n\nThe Milanuncios API is an unofficial Spain classifieds API for Milanuncios (milanuncios.com). It is not affiliated with Milanuncios. Search the marketplace by keyword, category, place or map radius with the filters buyers use on the site, or paste a milanuncios.com address and let the API read it for you. Open listings in full, see which listings have dropped in price, find out how a search splits across categories, and follow sellers, dealers and agencies to everything they have listed.\n\nIt is built for used car and real estate portals, price comparison and market research tools, dealer and agency lead generation products, classifieds aggregators and data teams that need anuncios clasificados and segunda mano data from the Spanish market in their own products.\n\n## Key Features\n\n- Search every category with 58 filters and 10 sort orders, including province, city, neighbourhood zone, coordinates with a radius, price, seller type and category-specific filters for cars, motorbikes, boats, trucks and real estate.\n- Look up any category's own filter definitions, with every accepted option value, so you can build filter panels.\n- Turn a word such as \"piso\" or \"iphone\" into matching categories and suggested searches.\n- Paste a milanuncios.com search address or listing address instead of building filters or extracting ids.\n- Open a listing with its full photo gallery, specifications, seller, store, statistics, financing offers and price rating on cars.\n- Search rows carry a cover photo, the photo count and a short description; the full gallery and text are on the listing detail endpoints.\n- Find reduced listings with the previous price and the size of each drop.\n- See how a keyword search splits across child categories.\n- Get similar listings, shipping methods with the full buyer cost, and seller phone numbers for listings that show phone contact.\n- Read seller profiles with trust badge and sales, and dealer and agency store profiles with their full inventory.\n- Resolve places in Spain: province, city and neighbourhood zone ids, address autocomplete, geocoding and reverse geocoding.\n\n## Available Data\n\nListing ids and addresses; titles and descriptions; prices, with the previous price on reduced listings; category paths; specifications such as make, model, year, mileage, fuel, transmission, surface, bedrooms and bathrooms, as listed on Milanuncios; province, region, city and neighbourhood zone ids; cover photos, full photo galleries and photo counts; publication and renewal dates; seller type, ad type and condition flags; reserved and shippable flags.\n\nListing detail also carries seller details, the store block, view, favourite and share statistics, shipping carriers, financing offers and the price rating on cars. Seller profiles carry the trust badge and sales, and store profiles carry the dealer or agency name, logo, website and published phone. Reference data covers the category tree, per-category filter definitions with every accepted option value, location ids, neighbourhood zones, street address suggestions, coordinates, postcodes, and city and province for a point in Spain.\n\n## Reference\n\n\n### `listCategories` (`/categories`)\n\nGet the full Milanuncios category tree, nested or flat, or just one subtree. Use it to get the `category_id` values that search takes and to build category menus.\n\n### `searchCategories` (`/search-categories`)\n\nTurn a word such as \"piso\" or \"iphone\" into matching categories and suggested searches. Use it for search boxes and to jump from a typed word to the category to search.\n\n### `getCategoryFilters` (`/category-filters`)\n\nGet the search filters one category supports, with every accepted option value and the minimum and maximum a form allows. Use it to build filter panels and to find valid values for the category-specific filters.\n\n### `searchLocations` (`/locations`)\n\nTurn a place name into province, region and city ids, each row carrying every enclosing id. Use it to get the location ids that search takes.\n\n### `listCityZones` (`/city-zones`)\n\nList the neighbourhood zones of a city with the `zone_id` that search takes. Use it for neighbourhood-level real estate and classifieds search.\n\n### `searchAddresses` (`/address-search`)\n\nTurn a street address being typed into address suggestions with a `place_id`. Use it for address boxes in front of geocoding.\n\n### `geocodePlace` (`/geocode`)\n\nGet coordinates, postcode, city and province for a `place_id` from address search. Use it to put an address on a map or to start a radius search.\n\n### `reverseGeocode` (`/reverse-geocode`)\n\nGet the address, city and province ids for a latitude and longitude in Spain. Use it to turn a map point into the location ids that search takes.\n\n## Search\n\n\n### `searchListings` (`/search`)\n\nSearch listings across every category with 58 filters and 10 sort orders, paginated. Filter by keyword, category, province, city, neighbourhood zone, coordinates with radius, price, seller type, condition and the category-specific filters for cars, motorbikes, real estate and more. Rows carry a cover photo, the photo count and a short description; the full gallery and text are on `getListing`. Car searches also carry financing offers and price ratings.\n\n### `searchListingsByUrl` (`/search-by-url`)\n\nPaste a milanuncios.com search or category address and get its listings back, together with the filters the address was understood to contain. Use it when your users start from a Milanuncios page.\n\n### `searchPriceDrops` (`/price-drops`)\n\nSearch listings whose price was cut, each with the previous price and the amount and percentage of the drop. It takes the same filters as `searchListings`. Use it for bargain finders and price tracking.\n\n### `getSearchCategoryCounts` (`/search-category-counts`)\n\nSee how the matches of a keyword search split across child categories. Use it for category facets and for market research on where a product is listed.\n\n## Listings\n\n\n### `getListing` (`/listing`)\n\nOpen one listing by id: price, full photo gallery, specifications, description, seller, store, statistics, shipping carriers, and on cars the financing offers and price rating.\n\n### `getListingByUrl` (`/listing-by-url`)\n\nPaste a milanuncios.com listing address and get the same full record `getListing` returns.\n\n### `listSimilarListings` (`/similar-listings`)\n\nGet the listings Milanuncios recommends alongside one listing. Use it for comparables, alternatives and \"you may also like\" lists.\n\n### `getListingShipping` (`/listing-shipping`)\n\nGet the shipping methods and the full buyer cost for a shippable listing: item price, shipping cost, service fee and total. Use it for delivery quotes and landed-cost comparisons.\n\n### `getListingPhone` (`/listing-phone`)\n\nGet the seller's phone number for a listing that shows phone contact. Use it for dealer and lead workflows.\n\n## Sellers\n\n\n### `getSellerProfile` (`/seller-profile`)\n\nGet a public seller profile with trust badge, sales on the platform and listing counts by state.\n\n### `listSellerListings` (`/seller-listings`)\n\nList every live listing of one seller, with the same filters and sort orders as search, paginated. Use it to size a seller or follow their stock.\n\n### `getStore` (`/store`)\n\nGet a professional store profile (dealer or agency) with logo, website and published phone.\n\n### `listStoreListings` (`/store-listings`)\n\nPage through a professional store's full inventory with the same filters and sort orders as search. Use it to track a dealer's or agency's stock and prices.\n\n## Plan Access\n\nEvery endpoint in the table is free to try on Basic. Pro includes listing search, listing detail, category reference and location and geocoding endpoints. Ultra adds seller and store profiles, price drops and category breakdowns, and shipping quotes. Mega includes every endpoint, including seller phone numbers. Basic is a trial of the whole API, so Pro and Ultra do not include every endpoint Basic can try; if you need every endpoint, choose Mega. A green tick means the endpoints in that row are available on the plan; a red cross means they are not.\n\n| Feature | Endpoints | Basic | Pro | Ultra | Mega |\n| --- | --- | :---: | :---: | :---: | :---: |\n| 🔎 Listing Search Data | `searchListings`, `searchListingsByUrl` | ✓ | ✓ | ✓ | ✓ |\n| 📄 Listing Detail Data | `getListing`, `getListingByUrl`, `listSimilarListings` | ✓ | ✓ | ✓ | ✓ |\n| 🗂️ Category Reference Data | `listCategories`, `searchCategories`, `getCategoryFilters` | ✓ | ✓ | ✓ | ✓ |\n| 📍 Location Geocoding Data | `searchLocations`, `listCityZones`, `searchAddresses`, `geocodePlace`, `reverseGeocode` | ✓ | ✓ | ✓ | ✓ |\n| 🏪 Seller Store Profiles | `getSellerProfile`, `listSellerListings`, `getStore`, `listStoreListings` | ✓ | ✗ | ✓ | ✓ |\n| 📈 Deal Market Insights | `searchPriceDrops`, `getSearchCategoryCounts` | ✓ | ✗ | ✓ | ✓ |\n| 🚚 Shipping Quote Data | `getListingShipping` | ✓ | ✗ | ✓ | ✓ |\n| 📞 Seller Phone Numbers | `getListingPhone` | ✓ | ✗ | ✗ | ✓ |\n\n## Common Use Cases\n\n- Build used car portals and car price comparison tools from coches de segunda mano listings.\n- Build real estate search apps for pisos, flats and houses for sale and for rent, down to the neighbourhood.\n- Research prices for cars, motorbikes, electronics and mobile phones by make, model, year, place and condition.\n- Track price drops and bargains across any category.\n- Follow dealer and agency inventory, prices and contact details over time.\n- Generate leads from sellers whose listings show phone contact.\n- Quote delivery and total buyer cost for shippable listings.\n- Power search pages that start from a pasted Milanuncios address.\n- Geocode addresses in Spain and search around a point.\n\n## Built for Developers\n\nEvery endpoint is a `GET` request with query parameters. Start with `listCategories`, `searchCategories`, `searchLocations` or `listCityZones` to get valid category, province, city and zone ids, then search and open the records your product needs. Use `getCategoryFilters` to learn which filters a category supports before you build a filter panel.\n\nSearch, price drop, seller and store endpoints return listings in one row shape, so the same code handles them all. Each row's `listing_id` opens `getListing`, `getListingShipping`, `getListingPhone` and `listSimilarListings`. Paged endpoints report `total` and a `next_offset`, and every request and response is documented with examples in the endpoint reference. Values are the source's own, as listed on Milanuncios.\n\n## Why Use This API?\n\n- Cover the Spanish classifieds market with one integration: search, listing detail, sellers, stores, shipping and geocoding.\n- Filter like a Milanuncios user: 58 filters with category-specific definitions you can read from the API.\n- Go beyond listings with price drops, category breakdowns, similar listings and shipping quotes.\n- Start from ids, keywords, places or pasted milanuncios.com addresses.\n- Search around a point, by province and city, or down to the neighbourhood zone.\n\n## API Categories\n\n- Reference\n- Search\n- Listings\n- Sellers\n\n## Start Building\n\nFind a category and a place, search Spain classifieds with the filters your users need, and open the listing, seller, store and shipping data your product requires. Start on Basic to try every endpoint, then choose Pro, Ultra or Mega according to the endpoints your production workflow needs.\n", "x-website": "https://www.milanuncios.com", "x-public": true, "x-thumbnail": "https://rapidapi-prod-apis.s3.amazonaws.com/80f5862e-32d7-4127-b33d-2d86e5e950d8.jpg", "x-version-lifecycle": "active", "termsOfService": "Unofficial Milanuncios (milanuncios.com) Spain classifieds data API; not affiliated with Milanuncios." }, "tags": [ { "name": "Reference", "description": "Reference", "index": 0 }, { "name": "Search", "description": "Search", "index": 1 }, { "name": "Listings", "description": "Listings", "index": 2 }, { "name": "Sellers", "description": "Sellers", "index": 3 }, { "name": "Health", "description": "Health", "index": 4 } ], "components": { "schemas": { "CommonHealthCheckResponse": { "type": "object", "properties": { "success": { "type": "boolean", "example": true } }, "required": [ "success" ] }, "MilanunciosSuccessResponseSchema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ true ], "example": true }, "data": { "nullable": true } }, "required": [ "success" ] }, "MilanunciosErrorResponseSchema": { "type": "object", "properties": { "success": { "type": "boolean", "enum": [ false ], "example": false }, "message": { "type": "string", "example": "An unexpected error occurred. Please try again." } }, "required": [ "success", "message" ] } }, "parameters": {} }, "paths": { "/status": { "get": { "tags": [ "Health" ], "responses": { "200": { "description": "Health check", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonHealthCheckResponse" } } } } } } }, "/categories": { "get": { "tags": [ "Reference" ], "operationId": "listCategories", "description": "The full category tree with the category_id every search filter takes.", "parameters": [ { "schema": { "type": "string", "maxLength": 15 }, "required": false, "description": "**List only the subtree rooted at this category, instead of the whole taxonomy.** Optional; a `category_id` from this same endpoint (e.g. `13` Coches, `131` Venta de pisos, `111` Móviles).\n\n- Every node under the id is returned, including the id itself, with the tree pruned above it; a leaf id returns just that node.\n- An id that names no category in the tree is a 404 — take ids from a call without `parent_id`, or from `/search-categories`.", "name": "parent_id", "in": "query" }, { "schema": { "type": "string", "enum": [ "tree", "flat" ], "default": "tree" }, "required": false, "description": "**Shape of the `categories` array.** Optional; default `tree`.\n\n- `tree` — nested nodes, each with its own `children` array (the Milanuncios category menu); use it to render a drill-down menu.\n- `flat` — every node in one list, each with `depth` (`0` = top-level vertical) and `path` (the ids from the top-level vertical down to the node, inclusive) instead of `children`; use it for a breadcrumb or a searchable list.", "name": "format", "in": "query" } ], "responses": { "200": { "description": "The Milanuncios category tree — the browse taxonomy whose `category_id` values `/search` and every other filterable endpoint take.\n\nReturns `total` (node count in the response), `format` (the shape returned) and `categories`: nested nodes in `tree` shape, or a flat list with `depth`/`path` in `flat` shape. Each node carries `category_id`, `name`, `slug` (`null` for an alias node — it has no page of its own), `parent_id` and `alias_of` (set when the node is an alias of another category — search that id instead).\n\n- Called with no parameters it lists the whole tree (every vertical: Motor, Inmobiliaria, Tecnología, Empleo, …); top-level verticals have `parent_id: null`.\n- Pass `parent_id` for just one subtree once you have an id from a previous call or `/search-categories`. `format=flat` is the easiest shape to search or paginate client-side.\n- **Car makes are not in the tree**: the make ids at the end of a car listing's `category_path` (e.g. `846` Seat, `814` Ferrari) are the only valid `/search` categories outside it (motorbike makes have no category id — filter them with `brand`); as a `parent_id` they return 404 like any other id outside the tree.\n\nThe 200 example below is the no-parameter call trimmed to one vertical (`44` Aficiones y ocio) and a few nodes per level; `total` still counts the full tree.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MilanunciosSuccessResponseSchema" }, "example": { "success": true, "data": { "total": 1093, "format": "tree", "categories": [ { "category_id": "44", "name": "Aficiones y ocio", "slug": "aficiones", "parent_id": null, "alias_of": null, "children": [ { "category_id": "599", "name": "Caza y pesca", "slug": "caza-y-pesca", "parent_id": "44", "alias_of": null, "children": [ { "category_id": "600", "name": "Caza", "slug": "caza", "parent_id": "599", "alias_of": null, "children": [ { "category_id": "603", "name": "Monterías", "slug": "monterias", "parent_id": "600", "alias_of": null, "children": [] }, { "category_id": "606", "name": "Todoterrenos", "slug": null, "parent_id": "600", "alias_of": "15", "children": [] } ] }, { "category_id": "607", "name": "Pesca", "slug": "pesca", "parent_id": "599", "alias_of": null, "children": [ { "category_id": "609", "name": "Cotos de pesca", "slug": "cotos-de-pesca", "parent_id": "607", "alias_of": null, "children": [] }, { "category_id": "611", "name": "Barcos", "slug": null, "parent_id": "607", "alias_of": "696", "children": [] } ] } ] }, { "category_id": "644", "name": "Coleccionismo", "slug": "coleccionismo", "parent_id": "44", "alias_of": null, "children": [ { "category_id": "1290", "name": "Airsoft", "slug": null, "parent_id": "644", "alias_of": "1100", "children": [] }, { "category_id": "662", "name": "Pins", "slug": "pins-de-coleccion", "parent_id": "644", "alias_of": null, "children": [] } ] }, { "category_id": "671", "name": "Karting", "slug": null, "parent_id": "44", "alias_of": "62", "children": [] } ] } ] } } } } }, "400": { "description": "Bad request — a parameter is missing, malformed or out of range; the message names it.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MilanunciosErrorResponseSchema" }, "example": { "success": false, "message": "Invalid request parameters. format: Invalid enum value. Expected 'tree' | 'flat', received 'zzz'" } } } }, "404": { "description": "Not found — the listing, seller, store, category or place does not exist (or no longer exists).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MilanunciosErrorResponseSchema" }, "example": { "success": false, "message": "No category with id 999999 in the category tree — take ids from /categories. Car make ids seen in a listing's `category_path` (846 Seat, 814 Ferrari) are valid /search categories but are not part of the browse tree (motorbike makes have no category id of their own)." } } } }, "500": { "description": "Internal error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MilanunciosErrorResponseSchema" }, "example": { "success": false, "message": "An unexpected error occurred. Please try again." } } } }, "503": { "description": "Temporarily busy — retry shortly.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MilanunciosErrorResponseSchema" }, "example": { "success": false, "message": "The service is temporarily busy, please try again shortly." } } } } } } }, "/search-categories": { "get": { "tags": [ "Reference" ], "operationId": "searchCategories", "description": "Turn a word like \"piso\" or \"iphone\" into matching category ids and suggested searches.", "parameters": [ { "schema": { "type": "string", "minLength": 1, "maxLength": 100, "example": "piso" }, "required": true, "description": "**A word or phrase to match against category names and Milanuncios keyword suggestions.** Required; 1–100 characters. Ex: `piso` (flats), `iphone`, `bicicleta`.\n\n- Matched against the Spanish category names, case-insensitive and insensitive to vowel accents (`camion` = `camión`) — but not to `ñ`: type `muñecas`, not `munecas`.\n- A query that matches nothing — including one with no letter or digit (`%`, `+`, an emoji) — returns empty `categories` and `suggestions` arrays with HTTP 200, not an error.\n- Text containing HTML/script markup (`