Gumtree

List Gumtree similar listings

List the listings Gumtree shows as similar to a listing, with prices and photos.

GET/v1/gumtree/listings/{listingId}/similar
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
listingIdstringrequiredpath

Gumtree listing id, the number at the end of the listing URL (e.g. `1510635374`), or the full listing URL.

pattern: ^\d{6,12}$

Response fields
50

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when the listing does not exist, has expired or was removed.

one of: found, not_found

datalistingId
string

Listing id, as requested.

Similar listings the listing page shows, usually 10.

datalistings[]id
string

Listing id.

datalistings[]title
string

Listing title.

datalistings[]url
string

Listing URL on gumtree.com.

Asking price; null when not shown.

datalistings[]priceamount
numbernullable

Price in pounds; null when the listing shows no number.

datalistings[]pricecurrency
string

Always `GBP`.

one of: GBP

datalistings[]pricetext
stringnullable

Price as shown, e.g. `£1,450.00`; null when none is shown.

datalistings[]description
stringnullable

Start of the description, as the result card shows it.

datalistings[]postedAt
stringnullable

When the listing was posted or last bumped up, ISO 8601 UTC.

datalistings[]postedAgo
stringnullable

Age as shown, e.g. `1 day ago`.

datalistings[]location
stringnullable

Town and area as shown, e.g. `Keith, Moray`.

datalistings[]postcodeDistrict
stringnullable

Postcode district (the first half of the postcode), e.g. `AB55`.

datalistings[]locationId
stringnullable

Gumtree location id of the listing's area.

Approximate map position; only when the seller lets the listing show a map.

datalistings[]coordinateslatitude
number

Latitude.

datalistings[]coordinateslongitude
number

Longitude.

datalistings[]distance
stringnullable

Distance from the searched location as shown, e.g. `2 miles`.

datalistings[]imageUrl
stringnullable

Main photo URL.

Every photo URL the card carries.

datalistings[]imageUrls[]
stringoptional
datalistings[]imageCount
integernullable

Number of photos on the listing.

datalistings[]hasVideo
booleannullable

Whether the listing has a video.

datalistings[]categoryId
stringnullable

Leaf category id.

Category ids from the top level down to the leaf.

datalistings[]categoryIds[]
stringoptional

Attributes the listing shows (condition, brand, mileage and so on).

datalistings[]attributes[]key
string

Attribute key, e.g. `vehicle_mileage` or `seller_type`.

datalistings[]attributes[]name
string

Label as shown, e.g. `Mileage`.

datalistings[]attributes[]value
string

Value as shown, e.g. `38700`.

datalistings[]attributes[]unit
stringnullable

Unit, e.g. `miles` or `mpg`; null when none.

datalistings[]sellerId
stringnullable

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`.

datalistings[]sellerUserId
stringnullable

Seller's numeric user id, as the listing's own 'other ads' link carries it. The seller endpoints don't take it: pass `sellerId`.

datalistings[]isTrade
booleannullable

Whether the seller is a business (trade) account.

datalistings[]featured
booleannullable

Paid featured placement.

datalistings[]urgent
booleannullable

Marked urgent.

datalistings[]standout
booleannullable

Paid highlighted card.

datalistings[]bumpedUp
booleannullable

Recently bumped to the top.

datalistings[]favouriteCount
integernullable

Number of people who saved the listing.

datalistings[]shippingAvailable
booleannullable

Whether the seller offers delivery.

datalistings[]status
stringnullable

Listing status, e.g. `LIVE`.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

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

metafetchedAt
stringoptional

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.