{"uid":"cap_XjIPthuIPQJYsQlgatNSS","slug":"gumtree-uk-listing-scraper-x402-df845e5c","name":"Gumtree UK Listing Scraper (x402)","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://x402.186-241-26-229.sslip.io/v1/gumtree?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"adId":null,"link":null,"title":null,"shortId":null,"priceText":null,"description":null,"priceAmount":null,"priceCurrency":null}],"product":"gumtree"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.035","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.035/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.035","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.035","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_SFbXTY7PxFGtdnRNken_g","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.035","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Find cheap second-hand furniture nearby","prompt":"Search Gumtree for second-hand sofas in Manchester, sort by lowest price first, and return up to 30 listings with full descriptions and images."},{"title":"Monitor new electronics listings","prompt":"Pull the latest Gumtree listings for iPhones in Birmingham posted after 2024-06-01, sorted by date, so I can see what's just come up for sale."},{"title":"Research market prices for a product category","prompt":"Scrape Gumtree for vintage guitars across the UK, get up to 100 results sorted by price highest first, and include full listing details so I can analyze what sellers are asking."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T03:38:32.890Z","isFirstParty":false,"canonicalSlug":"gumtree-uk-listing-scraper-x402-df845e5c"}