Skip to main content
GET
Get Listing
Fetch one Gumtree listing in full: the description, every category attribute, all images, location and coordinates, the seller’s profile and Gumtree’s similar listings. Motors listings carry the vehicle spec — in the UK make, model, mileage, MPG, CO2, insurance group, previous keepers and the vehicle history-check flags; in Australia make, model, variant, odometer, VIN and rego. Property, jobs, pets and services listings carry their own attribute sets. Credits: 5

Authorization

string
required
Your ScrapeBadger API key.

Path Parameters

string
required
Gumtree listing id from the end of the listing URL, returned as id by /search:
  • uk: ~10 digits, e.g. 1803293391.
  • au: ~10 digits, e.g. 1344981847.
  • za: the listing ref at the end of a gumtree.co.za/listing/<ref> URL, e.g. ls26bvmcpnsqmz7l9jz.

Query Parameters

string
default:"uk"
uk (gumtree.com), au (gumtree.com.au) or za (gumtree.co.za). Must match the site the listing id comes from — a za ref with uk / au, or a numeric id with za, is a 400.

Response

string
uk, au or za.
string
Listing id.
string
string
string
Full description text.
number
Numeric price in currency; null for negotiable or contact-for-price ads.
string
Price as shown, e.g. £5,699.00, $16,990, R190,000.
string
pm / pw for rentals.
string
au: FIXED, NEGOTIABLE, CONTACT_ME, FREE, SWAP_TRADE … za: ASKING_PRICE, POA …
string
GBP, AUD or ZAR.
string
Motors trade listings: Inc VAT / No VAT.
string
e.g. Larkhall, South Lanarkshire.
string
string
string
string
number
number
integer | string
Integer on uk / au, ref string on za (e.g. p6dnh).
string
(integer | string)[]
Root-to-leaf category ids (refs on za).
Breadcrumb[]
name, url.
string[]
string[]
string
Relative age as shown, e.g. 1 day ago.
number
Last (re)posted, Unix seconds — moves when the ad is bumped.
string
Same, ISO 8601 UTC.
number
When the ad was first created, Unix seconds.
string
Same, ISO 8601 UTC.
number
string
string
Date the ad is valid through (YYYY-MM-DD).
string
au: e.g. ACTIVE. za: e.g. PUBLISHED.
integer
au / za: views of this ad.
integer
au: replies to this ad.
boolean
boolean
boolean
integer
boolean
Motors: Gumtree’s vehicle history check ran on this car.
Attribute[]
Every category attribute — key, label, value, unit, e.g. {"key": "vehicle_mileage", "label": "Mileage", "value": "94130", "unit": "miles"}.
Seller
The seller’s profile.
string[]
Services listings only.
string
The seller’s other ads on the Gumtree site.
ListingSummary[]
Gumtree’s similar listings, in the same shape as /search listings.

Example

Response

South Africa

Response (abridged)

Australia

Response (abridged)
Phone numbers are masked. seller.phone_masked is the masked form shown on the public listing page (e.g. 0794997XXXX in the UK), or null when the seller shows none — always null in Australia and South Africa, where Gumtree puts phone numbers behind a login. The full number is never returned.
Vehicle history-check flags arrive as attributes with the value "true" — vehicle_not_stolen, vehicle_not_writeoff, vehicle_not_scrapped, vehicle_not_exported, vehicle_road_worthy — alongside vehicle_previous_keepers and vrn (the registration) where the seller shows it.

Errors