Get Gumtree listing
Get a Gumtree listing with its description, price, photos, attributes, location and seller.
Headers
Get your API keyAPI key (`sfk_...`)
Gumtree listing id, the number at the end of the listing URL (e.g. `1510635374`), or the full listing URL.
pattern: ^\d{6,12}$
Endpoint-specific response payload.
`not_found` when the listing does not exist, has expired or was removed.
one of: found, not_found
Listing id, as requested.
A Gumtree listing.
Listing id.
Listing title.
Listing URL on gumtree.com.
Full description, paragraphs separated by a blank line.
Asking price; null when not shown.
Price in pounds; null when the listing shows no number.
Always `GBP`.
one of: GBP
Price as shown, e.g. `£1,450.00`; null when none is shown.
When the listing was posted or last bumped up, ISO 8601 UTC.
Age as shown, e.g. `1 day ago`.
When the listing was first created, ISO 8601 UTC.
When the listing was last changed, ISO 8601 UTC.
Town and area as shown, e.g. `Keith, Moray`.
Town, e.g. `Keith`.
County or area, e.g. `Moray`.
Postcode district (the first half of the postcode), e.g. `AB55`.
Gumtree location id.
Approximate map position; only when the seller lets the listing show a map.
Latitude.
Longitude.
Leaf category id.
Leaf category name.
Breadcrumb from the top category down, with page URLs.
Breadcrumb label.
Breadcrumb page URL.
Every attribute the listing shows.
Attribute key, e.g. `vehicle_mileage` or `seller_type`.
Label as shown, e.g. `Mileage`.
Value as shown, e.g. `38700`.
Unit, e.g. `miles` or `mpg`; null when none.
Vehicle history check, on vehicle listings that show one; null otherwise.
Whether the extended check was run.
Not recorded as written off for scrap (insurance category A or B).
Not recorded as written off and repairable (category C or D).
Not recorded as written off with structural or non-structural damage (category S or N).
Not recorded as imported.
Still on its original number plate.
Still its original colour.
Photo URLs, in order.
Video URLs, when the listing has any.
Number of people who saved the listing.
Paid featured placement.
Marked urgent.
Paid highlighted card.
Recently bumped to the top.
Who is selling. No phone number or email is returned.
The 32-character seller id the seller endpoints take (`/v1/gumtree/sellers/{sellerId}`); null when the listing shows no profile (job ads).
Seller's numeric user id, the same as `sellerUserId` on result cards. The seller endpoints don't take it.
Contact name as shown: a first name or a business name.
`Private` or `Trade`, as the listing shows it.
Whether it is a business account.
How long the seller has posted, as shown, e.g. `16+ years`.
Typical reply time, when shown.
Reply rate, when shown.
Seller rating.
Average rating out of 5; null when the seller has none.
Number of ratings.
Number of ratings at each star level.
`gumtree` for buyer and seller reviews, `google` for a business's Google reviews.
Business website the listing links to, when it shows one.
Services a trade seller lists, e.g. `General Plumbing`.
Reviews of the seller shown on the listing (mostly trade sellers).
Reviewer display name as shown.
Stars out of 5.
When it was written, ISO 8601 UTC.
Review text; null when none.
`gumtree` or `google`, where the review was written.
Questions and answers on the listing, when any.
Question.
Seller answer.
How many similar listings the page shows (see the similar endpoint).
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.
one of: true
When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.
Code example
curl "https://api.socialfetch.dev/v1/gumtree/listings/1495075116" \
-H "x-api-key: YOUR_API_KEY"Responses
Gumtree listing.