{"uid":"cap_t-9gyIHqMxq4eOleorJ43","slug":"gumtree-uk-listings-scraper-c9e0bf62","name":"Gumtree UK Listings Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/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_O1RrqWsJ4X7mjkRn5zJxO","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 and returns structured listings data from Gumtree UK, including titles, prices, descriptions, and seller details, based on keyword, category, location, or direct URLs.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Price research for used electronics","prompt":"Search Gumtree UK for second-hand iPhones in Birmingham, sorted by lowest price first, and return up to 100 listings with full descriptions so I can see what they're going for."},{"title":"New listing monitoring for a niche category","prompt":"Pull all Gumtree listings in the 'other-bikes' category posted since 2024-06-01 in Manchester — I want the full details including seller name and images, sorted by date."},{"title":"Competitive analysis of local classified ads","prompt":"Scrape these three Gumtree search pages for sofa listings in Leeds and give me up to 200 results with prices and descriptions so I can compare what competitors are selling at."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:51.385Z","isFirstParty":false,"canonicalSlug":"gumtree-uk-listings-scraper-c9e0bf62"}