Gumtree API & Scraper
The Gumtree UK API returns classifieds listings from one of the UK's largest classifieds sites as clean JSON.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
The primary search endpoint returns items with id, title, price, URL, location, images, posted date, seller type and attributes, and you can pull a listing_detail, similar ads, categories, filters and suggestions. It is built for price intelligence, resale tools and UK classifieds analytics that need Gumtree data without a scraper. One ReefAPI key, one shared credit pool, the standard envelope.
Gumtree UK category slugs that search actually accepts
The category parameter takes a Gumtree slug, but not every slug shape works. The seven top-level trees work as written, and so do bare leaf slugs such as cars or property-to-rent. The path form that the categories action prints for sub-categories (cars-vans-motorbikes/cars) gets URL-encoded into the query string and Gumtree answers it with a 404. Counts below are live ad totals for the London area, measured 2026-08-27.
| Slug | Tree | Ads in London | Notes |
|---|---|---|---|
| for-sale | For Sale | 222,219 | Largest tree; leaf slug baby-kids-stuff returned 17,857 |
| business-services | Services | 28,130 | Trade-heavy; seller_type is populated here |
| cars-vans-motorbikes | Motors | 22,433 | Leaf slug cars returned 9,451, motors-parts 5,302 |
| flats-houses | Property | 15,546 | Leaf slug property-to-rent returned 4,974 |
| jobs | Jobs | 10,382 | seller_type came back null on all 30 rows sampled |
| pets | Pets | 1,797 | Leaf slug dogs returned 131 |
| community | Community | 504 | Smallest tree |
Sub-category slugs in path form (for-sale/baby-kids-stuff, pets/pets-for-sale/dogs) return NOT_FOUND with the upstream 404 URL in the message. Use the leaf slug on its own, or read the exact slugs Gumtree will accept, with live counts, from the filters action: for Motors in London it returned cars 9,450, motors-parts 5,302, motors-accessories 4,649, vans 1,366, motorbikes-scooters 1,313 and other-vehicles 243.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/gumtree/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"market": "uk",
"category": "cars-vans-motorbikes",
"location": "london",
"max_pages": 1
}
}{
"ok": true,
"meta": {
"api": "gumtree",
"endpoint": "search",
"mode": "live",
"latency_ms": 10146.7,
"record_count": 30,
"bytes": 777804,
"cache_hit": false,
"completeness_pct": 99.26,
"stop_reason": "max_pages",
"market": "uk",
"method": "clientData_ssr"
},
"data": {
"items": [
{
"id": 1514947205,
"title": "2019 Ford Transit 2.0 460 EcoBlue Trend RWD L4 High Roof Euro 6 (s/s) 5dr (17 Seat, DRW) Minibus ...",
"price": "£13,426.00",
"price_amount": 13426,
"price_currency": "GBP",
"url": "https://www.gumtree.com/p/vans/2019-ford-transit-2.0-460-ecoblue-trend-rwd-l4-high-roof-euro-6-s-s-5dr-17-seat-drw-minibus-.../[redacted-phone]",
"location": "Romford, London",
"item_type": "Product",
"category_id": 94,
"l1_category_id": 2551,
"l2_category_id": 94,
"posted_date": "2 days ago",
"posted_timestamp": 1784142015885,
"image_url": "https://img.gumtree.com/ePR8PyKf84wPHx7_RYmEag/17b3d4f[redacted-phone]af_cd065d970c6a/86",
"images": [
"https://img.gumtree.com/ePR8PyKf84wPHx7_RYmEag/17b3d4f[redacted-phone]af_cd065d970c6a/86",
"https://img.gumtree.com/ePR8PyKf84wPHx7_RYmEag/d4997b5e4ed44bb9bd_d6f039c56481/86",
"https://img.gumtree.com/ePR8PyKf84wPHx7_RYmEag/8600d301a685429e9f_b078100d6084/86"
],
"num_images": 56,
"has_video": true,
"seller_type": "Trade",
"short_description": "\nRcam+Psen+BT+Cruise+Acon+UlezThis 2019 Ford Transit 2.0 460 EcoBlue Trend RWD L4 H3 Euro 6 (s/s) 5dr (17 Seat, DRW) presents a superb opportunity, boasting a clear vehicle history check and having had only one owner from new. This 460 Trend derivati",
"distance": "14 miles",
"featured": true,
"urgent": false,
"premium": false,
"favourite_count": 3,
"attributes": [
{
"name": "[trimmed-depth]",
"value": "[trimmed-depth]",
"key": "[trimmed-depth]",
"vipOrder": "[trimmed-depth]",
"unit": "[trimmed-depth]"
},
{
"name": "[trimmed-depth]",
"value": "[trimmed-depth]",
"key": "[trimmed-depth]",
"vipOrder": "[trimmed-depth]",
"unit": "[trimmed-depth]"
},
{
"name": "[trimmed-depth]",
"value": "[trimmed-depth]",
"key": "[trimmed-depth]",
"vipOrder": "[trimmed-depth]",
"unit": "[trimmed-depth]"
}
]
},
{
"id": 1514946788,
"title": "2015 Citroen Grand C4 Picasso 1.6 THP Exclusive+ MPV 5dr Petrol EAT6 Euro 6 (s/s) (165 ps) MPV Pe...",
"price": "£9,188.00",
"price_amount": 9188,
"price_currency": "GBP",
"url": "https://www.gumtree.com/p/citroen/2015-citroen-grand-c4-picasso-1.6-thp-exclusive-mpv-5dr-petrol-eat6-euro-6-s-s-165-ps-mpv-pe.../[redacted-phone]",
"location": "Romford, London",
"item_type": "Car",
"category_id": 10304,
"l1_category_id": 2551,
"l2_category_id": 9311,
"posted_date": "2 days ago",
"posted_timestamp": 1784136015946,
"image_url": "https://img.gumtree.com/ePR8PyKf84wPHx7_RYmEag/60835c8b91534f1eb0_272a9eaa19d3/86",
"images": [
"https://img.gumtree.com/ePR8PyKf84wPHx7_RYmEag/60835c8b91534f1eb0_272a9eaa19d3/86",
"https://img.gumtree.com/ePR8PyKf84wPHx7_RYmEag/e00dabcb05a24ca695_e2ad0ee84aee/86",
"https://img.gumtree.com/ePR8PyKf84wPHx7_RYmEag/14ae20c4b4744cd394_08e6d46fc3a7/86"
],
"num_images": 76,
"has_video": false,
"seller_type": "Trade",
"short_description": "\nAuto+LowMiles+PSenThis 2015 Citroen Grand C4 Picasso THP Exclusive+ boasts exceptionally low mileage for its age, having covered just 53,500 miles. This 7 seat MPV is presented in the desirable Exclusive+ trim and features a responsive 1.6 litre pet",
"distance": "14 miles",
"featured": true,
"urgent": false,
"premium": false,
"favourite_count": 0,
"attributes": [
{
"name": "[trimmed-depth]",
"value": "[trimmed-depth]",
"key": "[trimmed-depth]",
"vipOrder": "[trimmed-depth]",
"unit": "[trimmed-depth]"
},
{
"name": "[trimmed-depth]",
"value": "[trimmed-depth]",
"key": "[trimmed-depth]",
"vipOrder": "[trimmed-depth]",
"unit": "[trimmed-depth]"
},
{
"name": "[trimmed-depth]",
"value": "[trimmed-depth]",
"key": "[trimmed-depth]",
"vipOrder": "[trimmed-depth]",
"unit": "[trimmed-depth]"
}
]
},
{
"id": 1515547029,
"title": "2021 Ford Puma 1.0T EcoBoost MHEV ST-Line SUV 5dr Petrol DCT Euro 6 (s/s) (125 ps) SUV Petrol Aut...",
"price": "£13,788.00",
"price_amount": 13788,
"price_currency": "GBP",
"url": "https://www.gumtree.com/p/ford/2021-ford-puma-1.0t-ecoboost-mhev-st-line-suv-5dr-petrol-dct-euro-6-s-s-125-ps-suv-petrol-aut.../[redacted-phone]",
"location": "Romford, London",
"item_type": "Car",
"category_id": 10306,
"l1_category_id": 2551,
"l2_category_id": 9311,
"posted_date": "1 day ago",
"posted_timestamp": 1784235615582,
"image_url": "https://img.gumtree.com/ePR8PyKf84wPHx7_RYmEag/7874ec31a9a7439696_b8aa0e1ad328/86",
"images": [
"https://img.gumtree.com/ePR8PyKf84wPHx7_RYmEag/7874ec31a9a7439696_b8aa0e1ad328/86",
"https://img.gumtree.com/ePR8PyKf84wPHx7_RYmEag/91b25c5e805b4487a3_c[redacted-phone]a3/86",
"https://img.gumtree.com/ePR8PyKf84wPHx7_RYmEag/8fbabe2e896b4b09bf_a620fce55003/86"
],
"num_images": 51,
"has_video": false,
"seller_type": "Trade",
"short_description": "\nIntroducing the stunning Ford Puma 1.0T EcoBoost MHEV ST-Line SUV in a sleek Silver finish. This impressive vehicle has only had one owner and comes with a mileage of 43000 miles, ensuring both quality and reliability.Equipped with a range of fantas",
"distance": "14 miles",
"featured": true,
"urgent": false,
"premium": false,
"favourite_count": 0,
"attributes": [
{
"name": "[trimmed-depth]",
"value": "[trimmed-depth]",
"key": "[trimmed-depth]",
"vipOrder": "[trimmed-depth]",
"unit": "[trimmed-depth]"
},
{
"name": "[trimmed-depth]",
"value": "[trimmed-depth]",
"key": "[trimmed-depth]",
"vipOrder": "[trimmed-depth]",
"unit": "[trimmed-depth]"
},
{
"name": "[trimmed-depth]",
"value": "[trimmed-depth]",
"key": "[trimmed-depth]",
"vipOrder": "[trimmed-depth]",
"unit": "[trimmed-depth]"
}
]
}
],
"count": 30,
"market": "uk",
"query": {
"q": null,
"location": "london",
"category": "cars-vans-motorbikes",
"sort": "date",
"min_price": null,
"max_price": null,
"distance": null,
"seller_type": null,
"url": null
},
"result_count": 23969,
"result_count_display": "23,969",
"pages_fetched": 1,
"total_pages": 50,
"location_title": "London",
"stop_reason": "max_pages",
"result_cap_hit": true,
"result_cap_note": "Gumtree paginates at most ~50 pages × 30 = ~1,500 ads/query. result_count is the true market total; split by sub-category/location/price to harvest beyond the cap.",
"source_layer": "clientData"
}
}What the Gumtree API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search Gumtree UK adverts and return paginated listing cards — title, price, location, posted date, images, seller type and attributes. Filter by keyword, area/postcode, category slug, price range, search radius and seller type; sort by newest, price or distance. Fetches up to 50 pages (~1,500 adverts) per call with automatic de-duplication, or pass a full Gumtree search URL. | Pricing teams call search to search Gumtree UK adverts and. | market, query, location, category, url, ... |
| listing_detail | Full advert detail by listing `url` OR numeric `id`: title, full description, price, all photos, every attribute (mileage, year, bedrooms, condition…), map coordinates, location/postcode, category breadcrumbs and the public seller profile (display name, rating, total adverts, ads per category, member-since). | Marketplace operators call listing_detail to get full advert detail by listing `url` OR numeric `id`. | market, url, id, include_pii |
| similar | Related / similar adverts for a given listing (by `url` or `id`) — Gumtree's own 'you might also like' recommendations as clean listing cards. | Catalog enrichment teams call similar to get related / similar adverts for a given listing (by `url` or `id`). | market, url, id, include_pii |
| categories | Gumtree's full browse tree — the top-level categories (Motors, For Sale, Property, Jobs, Pets, Services, Community) and their sub-categories with slugs and paths. Use the slugs as the `category` parameter of search / filters. | Retail analysts call categories to get gumtree's full browse tree. | market |
| filters | Available filters & facets for a category and/or location: selectable sub-categories (with live advert counts), area / postcode facets (with counts), sort options, search-radius options and the price filter. Lets a caller discover valid category slugs, location values and result sizes before searching. | Pricing teams call filters to get available filters & facets for a category and/or location. | market, category, location, query |
| suggestions | Keyword suggestions & spelling corrections for a search term — Gumtree's 'did you mean' / related-keyword surface, useful for query expansion and autocomplete-style discovery. | Marketplace operators call suggestions to get keyword suggestions & spelling corrections for a search term. | query, market, location, category |
Call search from your stack
curl -X POST https://api.reefapi.com/gumtree/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"market":"uk","category":"cars-vans-motorbikes","location":"london","max_pages":1}'import requests
r = requests.post(
"https://api.reefapi.com/gumtree/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"market": "uk",
"category": "cars-vans-motorbikes",
"location": "london",
"max_pages": 1
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/gumtree/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"market": "uk",
"category": "cars-vans-motorbikes",
"location": "london",
"max_pages": 1
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.gumtree.search with {"market":"uk","category":"cars-vans-motorbikes","location":"london","max_pages":1}.Who uses this API and why
- Price-intelligence teams call search to track second-hand prices across Gumtree categories.
- Resale and arbitrage tools use similar to find comparable listings for a product.
- Market analysts use categories and filters to size supply in a UK classifieds segment.
Questions developers ask before integrating
Does this cover Gumtree UK, Gumtree Australia, or both?
UK only. market defaults to uk (gumtree.com) and that is the marketplace every action reads. Passing market=au returns a typed MARKET_UNAVAILABLE error rather than an empty list, because gumtree.com.au serves a bare 403 to non-Australian connections. Every price therefore comes back with price_currency GBP.
Is the Gumtree price a number or free text?
Both, in two separate fields. price is Gumtree's own formatted string, for example £2,500.00, and price_amount is the parsed float 2500.0. Ads with no price return price as an empty string and price_amount as null, which is the normal case in Jobs: every row in a Manchester jobs search came back that way. Filter on price_amount, display price.
What does a Gumtree ad id look like and where does it come from?
It is the digits at the end of an advert URL, for example 1801851557 in /p/toyota/toyota-prius-hatchback-2011.../1801851557. search returns it as an integer in items[].id, while listing_detail and similar take it as a string in id. Ids are not zoned by category: a Motors ad measured 1801851557 and a Jobs ad 5418826988, both ten digits.
Can I tell a private seller from a dealer?
In Motors and For Sale, yes: seller_type comes back as Private or Trade on each card, and the seller_type parameter narrows to one of them. In Jobs it is null on every row, because Gumtree does not classify job posters that way. The seller_type filter still changes the result set there, so check the field rather than assuming the filter applied.
How deep can I page a Gumtree search?
About 1,500 ads per query. Gumtree serves roughly 30 ads per page and stops at 50 pages, so max_pages is capped at 50 and the response sets result_cap_hit true. result_count is Gumtree's own market total and is far larger than what you can page to: 22,433 for Motors in London against a 1,500-ad ceiling. Split by leaf category, area or price band to get past it.
What location values work, and how does the distance filter behave?
A town, an area or a postcode all resolve: london, manchester and SW1A were all accepted, and location_title echoes what Gumtree decided, for example SW1A - Within 5 miles. distance takes miles and needs location. The filters action returns the exact area facets with counts for your category, for example east-london 6,733 and north-west-london 5,627 under Motors, which is a more reliable way to slice a city than a radius.
How is this different from the autotrader or olx engines?
Gumtree is a general classifieds site, so one response mixes trees and the per-ad attributes[] array changes shape with the category. A car search row carried 40 attributes including vehicle_estimated_mileage 180256 and vehicle_cap_code, while a job row carried 12 including job_hours Part Time. autotrader is UK cars only and keeps mileage in badges; here it is an attribute you read by key. Gumtree also publishes a postcode and coordinates on listing_detail, HA98PB at 51.5711 / -0.294532 on the measured ad.
What does the seller block on listing_detail contain?
A public profile, not contact details. Measured on ad 1801851557: name salim, a hashed public_id, posting_since 15+ years, total_ads 10, ads_posted_last_year 5, last_active as an ISO timestamp, and ads_by_category counting Motors 5, For Sale 2, Property 2 and Services 1. Phone and email that sellers paste into free text are redacted unless you set include_pii true; the display name is always kept.
What is the Gumtree API?
Gumtree API is a ReefAPI endpoint group for uk classifieds listings with full details. It returns live JSON through POST requests under /gumtree/v1.
Is the Gumtree API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Gumtree calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Gumtree login or account?
No login to Gumtree is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Gumtree data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Gumtree API use?
Gumtree actions currently cost 1 credit per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.
Can I call Gumtree from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call gumtree actions with the same key, credit pool and JSON envelope used by normal REST requests.