# Gumtree UK Listings Scraper

> Gumtree UK Listings Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.035/call, status unknown (last checked 2026-10-02).

Scrapes and returns structured listings data from Gumtree UK, including titles, prices, descriptions, and seller details, based on keyword, category, location, or direct URLs.

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/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-listings-scraper-c9e0bf62
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_t-9gyIHqMxq4eOleorJ43

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-listings-scraper-c9e0bf62 -d '<json body>'
```

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

## When to prefer this

Choose this endpoint when you need structured, machine-readable data from Gumtree UK classifieds — especially for price research, inventory monitoring, or lead generation based on UK second-hand goods listings. It handles pagination, full listing detail extraction, and flexible filtering in a single call, with no charge for failed or empty runs.

## Known failure modes

- Empty result set if keyword/location combination returns no Gumtree listings — not charged
- Gumtree anti-scraping measures may cause partial or failed runs — not charged if empty
- Invalid category slug returns no results
- startUrls pointing to non-Gumtree or invalid pages may yield empty responses
- Date filtering (listingStartDate) may skip all results if date is too recent

## 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 and an array of listing items, each containing adId, link, title, shortId, priceText, priceAmount, priceCurrency, and optionally full description, seller display name, images, and category details when includeListingDetails is true.

## 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-listings-scraper-c9e0bf62/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)