# Gumtree UK Listing Scraper (x402)

> Gumtree UK Listing Scraper (x402) is a paid API for AI agents from x402.186-241-26-229.sslip.io, paid per call via x402, $0.035/call, status unknown (last checked 2026-10-02).

Scrapes Gumtree.com UK classified listings by keyword, category, location, or direct URL and returns structured listing data including title, price, description, and seller info.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/v1/gumtree?utm_source=zero.xyz
- Price: $0.035/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gumtree-uk-listing-scraper-x402-df845e5c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XjIPthuIPQJYsQlgatNSS

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 gumtree-uk-listing-scraper-x402-df845e5c -d '<json body>'
```

Example prompt: Search Gumtree for used road bikes in London, sort by price lowest first, and give me up to 50 listings posted since 2024-01-01 with full descriptions and seller details.

## When to prefer this

Use this endpoint when you need structured, machine-readable data from Gumtree UK classifieds and do not want to parse raw HTML yourself. Prefer this over generic web scrapers when targeting Gumtree specifically, as it handles pagination, listing detail extraction, seller info, and image URLs natively. The pay-per-successful-call model makes it cost-effective since failed or empty runs are not charged.

## Known failure modes

- No listings found matching query — returns empty items array and is not charged
- Gumtree blocks or rate-limits the scraper — may return partial results
- Invalid category slug results in no results
- startUrls pointing to non-Gumtree pages are ignored or cause errors
- listingStartDate in wrong format causes parameter to be ignored
- maxPages exceeds Gumtree's 50-page limit — capped at 50

## How this service works

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

## Output

A JSON object containing a count of matched listings and an array of listing items, each with fields for ad ID, title, link, short ID, price text, price amount, price currency, and optionally full description, seller display name, images, and category details.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sort": {
   "enum": [
    "relevance",
    "date",
    "price_lowest_first",
    "price_highest_first",
    "distance"
   ],
   "type": "string",
   "default": "date",
   "description": "Order for keyword search. Search URL parameters take precedence."
  },
  "keyword": {
   "type": "string",
   "description": "UK search phrase when no start URLs are supplied; for example bicycle."
  },
  "category": {
   "type": "string",
   "description": "Optional search_category slug, such as other-bikes, for keyword search."
  },
  "location": {
   "type": "string",
   "description": "UK city or region for keyword search; for example London."
  },
  "maxItems": {
   "type": "integer",
   "default": 100,
   "minimum": 1,
   "description": "Maximum unique listings across all start URLs."
  },
  "maxPages": {
   "type": "integer",
   "default": 50,
   "maximum": 50,
   "minimum": 1,
   "description": "Maximum pages per search URL. Gumtree currently exposes up to 50 pages per search."
  },
  "startUrls": {
   "type": "array",
   "description": "Public gumtree.com search pages or individual listing URLs. Takes precedence over keyword search."
  },
  "listingStartDate": {
   "type": "string",
   "description": "Optional earliest posting date in YYYY-MM-DD format; listings before it are skipped."
  },
  "includeListingDetails": {
   "type": "boolean",
   "default": true,
   "description": "Open each listing for full description, seller display name, images, and category details."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "adId": null,
    "link": null,
    "title": null,
    "shortId": null,
    "priceText": null,
    "description": null,
    "priceAmount": null,
    "priceCurrency": null
   }
  ],
  "product": "gumtree"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gumtree-uk-listing-scraper-x402-df845e5c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.186-241-26-229.sslip.io](https://www.zero.xyz/host/x402.186-241-26-229.sslip.io/llms.txt)