List Gumtree similar listings
List the listings Gumtree shows as similar to a listing, with prices and photos.
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.
Similar listings the listing page shows, usually 10.
Listing id.
Listing title.
Listing URL on gumtree.com.
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.
Start of the description, as the result card shows it.
When the listing was posted or last bumped up, ISO 8601 UTC.
Age as shown, e.g. `1 day ago`.
Town and area as shown, e.g. `Keith, Moray`.
Postcode district (the first half of the postcode), e.g. `AB55`.
Gumtree location id of the listing's area.
Approximate map position; only when the seller lets the listing show a map.
Latitude.
Longitude.
Distance from the searched location as shown, e.g. `2 miles`.
Main photo URL.
Every photo URL the card carries.
Number of photos on the listing.
Whether the listing has a video.
Leaf category id.
Category ids from the top level down to the leaf.
Attributes the listing shows (condition, brand, mileage and so on).
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.
The 32-character seller id the seller endpoints take. Seller listings carry it; search and similar results are null, because their cards don't: get it from the listing endpoint's `seller.sellerId`.
Seller's numeric user id, as the listing's own 'other ads' link carries it. The seller endpoints don't take it: pass `sellerId`.
Whether the seller is a business (trade) account.
Paid featured placement.
Marked urgent.
Paid highlighted card.
Recently bumped to the top.
Number of people who saved the listing.
Whether the seller offers delivery.
Listing status, e.g. `LIVE`.
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/similar" \
-H "x-api-key: YOUR_API_KEY"Responses
Gumtree similar listings.