Skip to main content
GET
Get Listing
Fetch one Gumtree listing in full: the description, every category attribute, all images, postcode and coordinates, the seller’s profile and Gumtree’s similar listings. Motors listings carry the full vehicle spec — make, model, mileage, MPG, CO2, insurance group, previous keepers and the vehicle history-check flags. 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 — the number at the end of a gumtree.com/p/... URL, e.g. 1803293391. Returned as id by /search.

Response

string
Listing id.
string
string
string
Full description text.
number
Numeric price in GBP.
string
Price as shown, e.g. £5,699.00.
string
pm / pw for rentals.
string
Always GBP.
string
Motors trade listings: Inc VAT / No VAT.
string
e.g. Larkhall, South Lanarkshire.
string
string
string
string
number
number
integer
string
integer[]
Root-to-leaf category ids.
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).
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 gumtree.com.
ListingSummary[]
Gumtree’s similar listings, in the same shape as /search listings.

Example

Response
Phone numbers are masked. seller.phone_masked is the masked form shown on the public listing page (e.g. 0794997XXXX), or null when the seller shows none. 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