docs / gumtree

Gumtree

UK classifieds listings with full details.

base /gumtree/v12 endpoints

post/gumtree/v1/search1 credit

paginated classifieds listings → results[]{title,price,url,location,...}. `query` / `location` / `category` / `url` / `sort` / `max_pages`. `market`=uk (live) | au (geo-fenced → TARGET_BLOCKED).

Parameter	Required
market	optional
query	optional
location	optional
category	optional
url	optional
sort	optional
max_pages	optional
page	optional
include_pii	optional

Try in playground →

post/gumtree/v1/listing_detail1 credit

full listing by `url` OR `id` (description + attrs + images + coords + seller). `market`=uk (live) | au (geo-fenced).

Parameter	Required
market	optional
url	optional
id	optional
include_pii	optional

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
}