docs / gumtree

Gumtree

UK classifieds listings with full details.

base /gumtree/v12 endpoints

post/gumtree/v1/search1 credit

Search Gumtree UK classifieds and return paginated listing cards — title, price, location, posted date and thumbnail. Filter by keyword, area/postcode, category slug (e.g. cars-vans-motorbikes) or pass a full Gumtree search URL. Fetches up to 50 pages (~1,500 listings) in one call with automatic deduplication.

Parameter		Allowed / range	Description
query	optional	—	What 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).
category	optional	—	Category slug from a Gumtree URL (gumtree.com/<slug>) — verified: cars-vans-motorbikes, for-sale. Optional.
url	optional	—	A full Gumtree search URL to run as-is (advanced — overrides query/location/category/sort).
sort = date	optional	date · price_lowest_first · price_highest_first · distance · relevance	Result ordering.
max_pages = 1	optional	1–50	How many result pages to fetch + dedup in one call (1–50, ~30 ads/page; larger values are capped at 50).
market = uk	optional	uk · au	Which Gumtree marketplace to search. UK (gumtree.com) is live. Australia (gumtree.com.au) requires an AU-based connection — not yet available.
include_pii = false	optional	—	Include seller contact reveal-tokens (redacted by default; public display name is always kept).

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		Allowed / range	Description
url	optional	—	Full listing URL from search results. Provide url OR id.
id	optional	—	Listing ID — the digits at the end of the listing URL. Alternative to url.
market = uk	optional	uk · au	Which Gumtree marketplace to search. UK (gumtree.com) is live. Australia (gumtree.com.au) requires an AU-based connection — not yet available.
include_pii = false	optional	—	Include seller contact reveal-tokens (redacted by default; public display name is always kept).

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
}