E-commerce & Marketplaces

Gumtree API

The Gumtree UK API returns classifieds listings from one of the UK's largest classifieds sites as clean JSON.

6 actionsLive JSON1,000 free creditsMCP-ready

🤖 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.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on Jul 18, 2026, 5:19 PM UTC.

Captured request

{
  "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
  }
}

Captured response

{
  "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"
  }
}

Actions

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

Code samples

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();

MCP one-liner

Ask your MCP-connected assistant: call reefapi.gumtree.search with {"market":"uk","category":"cars-vans-motorbikes","location":"london","max_pages":1}.

Use cases

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.

FAQ

Questions developers ask before integrating

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.

Is the Gumtree API a Gumtree scraper?

It is the managed alternative to a DIY Gumtree scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same uk classifieds listings with full details back as clean JSON.

Why does my Gumtree scraper keep getting blocked?

Most Gumtree scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked or failed calls are free.

docs / gumtree

Gumtree

UK classifieds listings with full details.

base /gumtree/v16 endpoints

post/gumtree/v1/search1 credit

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.

Parameter		Allowed / range	Description
query	optional	—	Keyword to search for. Give at least one of query / location / category / url.
location	optional	—	Town / area / postcode to search in (e.g. london, manchester, SW1A). Resolve area names with the filters action.
category	optional	—	Category slug from the categories action (e.g. cars-vans-motorbikes, for-sale, flats-houses, jobs, pets, business-services, community, or a sub-slug like for-sale/baby-kids-stuff). Optional.
url	optional	—	A full Gumtree search URL to run as-is (advanced — overrides the other search params).
sort = date	optional	date · price_lowest_first · price_highest_first · distance · relevance	Result ordering.
min_price	optional	—	Minimum price filter (in GBP).
max_price	optional	—	Maximum price filter (in GBP).
distance	optional	—	Search radius in miles around `location` (1, 3, 5, 10, 15, 25, 50, 75…). Needs location.
seller_type	optional	trade · private	Restrict to trade or private sellers.
featured_only = false	optional	—	Only return featured (promoted) adverts.
with_photos = false	optional	—	Only return adverts that include at least one photo.
max_pages = 1	optional	1–50	How many result pages to fetch + de-dup in one call (1–50, ~30 ads/page; larger values are capped at 50).
market = uk	optional	uk · au	Which Gumtree marketplace. UK (gumtree.com) is live. Australia (gumtree.com.au) is geo-fenced to Australian connections and not yet available.
include_pii = false	optional	—	Keep phone/email contact details that sellers paste into free text (redacted by default; the public display name is always kept).

Try in playground →

post/gumtree/v1/listing_detail1 credit

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).

Parameter		Allowed / range	Description
url	optional	—	Full advert URL from a search result. Provide url OR id.
id	optional	—	Advert ID — the digits at the end of an advert URL. Alternative to url.
market = uk	optional	uk · au	Which Gumtree marketplace. UK (gumtree.com) is live. Australia (gumtree.com.au) is geo-fenced to Australian connections and not yet available.
include_pii = false	optional	—	Keep phone/email contact details that sellers paste into free text (redacted by default; the public display name is always kept).

Try in playground →

post/gumtree/v1/similar1 credit

Related / similar adverts for a given listing (by `url` or `id`) — Gumtree's own 'you might also like' recommendations as clean listing cards.

Parameter		Allowed / range	Description
url	optional	—	Full advert URL. Provide url OR id.
id	optional	—	Advert ID. Alternative to url.
market = uk	optional	uk · au	Which Gumtree marketplace. UK (gumtree.com) is live. Australia (gumtree.com.au) is geo-fenced to Australian connections and not yet available.
include_pii = false	optional	—	Keep phone/email contact details that sellers paste into free text (redacted by default; the public display name is always kept).

Try in playground →

post/gumtree/v1/categories1 credit

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.

Parameter		Allowed / range	Description
market = uk	optional	uk · au	Which Gumtree marketplace. UK (gumtree.com) is live. Australia (gumtree.com.au) is geo-fenced to Australian connections and not yet available.

Try in playground →

post/gumtree/v1/filters1 credit

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.

Parameter		Allowed / range	Description
category	optional	—	Category slug from the categories action (e.g. cars-vans-motorbikes, for-sale, flats-houses, jobs, pets, business-services, community, or a sub-slug like for-sale/baby-kids-stuff). Optional.
location	optional	—	Town / area / postcode to search in (e.g. london, manchester, SW1A). Resolve area names with the filters action.
query	optional	—	Keyword to search for. Give at least one of query / location / category / url.
market = uk	optional	uk · au	Which Gumtree marketplace. UK (gumtree.com) is live. Australia (gumtree.com.au) is geo-fenced to Australian connections and not yet available.

Try in playground →

post/gumtree/v1/suggestions1 credit

Keyword suggestions & spelling corrections for a search term — Gumtree's 'did you mean' / related-keyword surface, useful for query expansion and autocomplete-style discovery.

Parameter		Allowed / range	Description
query	optional	—	Keyword to search for. Give at least one of query / location / category / url.
location	optional	—	Town / area / postcode to search in (e.g. london, manchester, SW1A). Resolve area names with the filters action.
category	optional	—	Category slug from the categories action (e.g. cars-vans-motorbikes, for-sale, flats-houses, jobs, pets, business-services, community, or a sub-slug like for-sale/baby-kids-stuff). Optional.
market = uk	optional	uk · au	Which Gumtree marketplace. UK (gumtree.com) is live. Australia (gumtree.com.au) is geo-fenced to Australian connections and not yet available.

Try in playground →

Example request · search

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}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}