# Milanuncios Listing Search API

> Milanuncios Listing Search API is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Searches and retrieves structured classified ad listings from Milanuncios, Spain's largest second-hand marketplace, with filtering by category, price, seller type, and shipping availability.

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/milanuncios?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/milanuncios-listing-search-api-49deeebc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kep0ko6wU_0k5US_pYyQu

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability milanuncios-listing-search-api-49deeebc -d '<json body>'
```

Example prompt: Search Milanuncios for used road bikes priced between 200 and 800 EUR, sorted by cheapest first, private sellers only, up to 50 listings.

## When to prefer this

Use this endpoint when you need structured data from Milanuncios specifically — Spain's dominant second-hand classifieds platform — including price history, location, and seller type. Prefer this over generic web scrapers when you need clean, schema-normalized listing data with advanced filtering (price range, category, shipping, seller type) and pagination beyond the site's native limits.

## Known failure modes

- Empty results if search terms match no listings (not charged)
- Failed run if Milanuncios is unreachable or blocks the scrape (not charged)
- Invalid category enum value returns a validation error
- priceFrom greater than priceTo may return empty or unexpected results
- maxResults very large may increase latency significantly

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

Returns a JSON object with a count of matched listings and an array of items, each containing the listing ID, URL, title, description, price, previous price, and location on Milanuncios.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sort": {
   "enum": [
    "relevance",
    "newest",
    "cheap",
    "expensive"
   ],
   "type": "string",
   "default": "relevance",
   "description": "Order search results by relevance, newest date, or asking price."
  },
  "text": {
   "type": "string",
   "description": "Words to search across listing titles and descriptions. Leave empty to browse a category."
  },
  "priceTo": {
   "type": "integer",
   "minimum": 0,
   "description": "Maximum asking price in EUR."
  },
  "category": {
   "enum": [
    "",
    "1",
    "32",
    "3",
    "40",
    "184",
    "185",
    "2",
    "9",
    "83",
    "39",
    "30",
    "43",
    "513",
    "44",
    "31",
    "612",
    "2064"
   ],
   "type": "string",
   "default": "",
   "description": "Top-level category to search."
  },
  "priceFrom": {
   "type": "integer",
   "minimum": 0,
   "description": "Minimum asking price in EUR."
  },
  "maxResults": {
   "type": "integer",
   "default": 100,
   "minimum": 1,
   "description": "Stop after this many unique listings. Large searches are divided into price ranges beyond the site pagination cap."
  },
  "sellerType": {
   "enum": [
    "",
    "private",
    "professional"
   ],
   "type": "string",
   "default": "",
   "description": "Keep only private or professional listings. This filter is applied to search results."
  },
  "isShippable": {
   "type": "boolean",
   "default": false,
   "description": "Only search listings marked as available for shipping."
  },
  "transaction": {
   "enum": [
    "",
    "supply",
    "demand"
   ],
   "type": "string",
   "default": "",
   "description": "For-sale listings or wanted listings."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "id": null,
    "url": null,
    "price": null,
    "title": null,
    "location": null,
    "priceValue": null,
    "description": null,
    "previousPrice": null
   }
  ],
  "product": "milanuncios"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/milanuncios-listing-search-api-49deeebc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)