Gumtree

Get Gumtree listing

Get a Gumtree listing with its description, price, photos, attributes, location and seller.

GET/v1/gumtree/listings/{listingId}
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
89

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.

A Gumtree listing.

datalistingid
string

Listing id.

datalistingtitle
string

Listing title.

datalistingurl
string

Listing URL on gumtree.com.

datalistingdescription
stringnullable

Full description, paragraphs separated by a blank line.

Asking price; null when not shown.

datalistingpriceamount
numbernullable

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

datalistingpricecurrency
string

Always `GBP`.

one of: GBP

datalistingpricetext
stringnullable

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

datalistingpostedAt
stringnullable

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

datalistingpostedAgo
stringnullable

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

datalistingcreatedAt
stringnullable

When the listing was first created, ISO 8601 UTC.

datalistingupdatedAt
stringnullable

When the listing was last changed, ISO 8601 UTC.

datalistinglocation
stringnullable

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

datalistingtown
stringnullable

Town, e.g. `Keith`.

datalistingarea
stringnullable

County or area, e.g. `Moray`.

datalistingpostcodeDistrict
stringnullable

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

datalistinglocationId
stringnullable

Gumtree location id.

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

datalistingcoordinateslatitude
number

Latitude.

datalistingcoordinateslongitude
number

Longitude.

datalistingcategoryId
stringnullable

Leaf category id.

datalistingcategoryName
stringnullable

Leaf category name.

Breadcrumb from the top category down, with page URLs.

datalistingcategoryPath[]name
string

Breadcrumb label.

datalistingcategoryPath[]url
string

Breadcrumb page URL.

Every attribute the listing shows.

datalistingattributes[]key
string

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

datalistingattributes[]name
string

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

datalistingattributes[]value
string

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

datalistingattributes[]unit
stringnullable

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

Vehicle history check, on vehicle listings that show one; null otherwise.

datalistinghistoryCheckextended
booleannullable

Whether the extended check was run.

datalistinghistoryChecknotCategoryAOrB
booleannullable

Not recorded as written off for scrap (insurance category A or B).

datalistinghistoryChecknotCategoryCOrD
booleannullable

Not recorded as written off and repairable (category C or D).

datalistinghistoryChecknotCategorySOrN
booleannullable

Not recorded as written off with structural or non-structural damage (category S or N).

datalistinghistoryChecknotImported
booleannullable

Not recorded as imported.

datalistinghistoryCheckoriginalNumberPlate
booleannullable

Still on its original number plate.

datalistinghistoryCheckoriginalColour
booleannullable

Still its original colour.

Photo URLs, in order.

datalistingimages[]
stringoptional

Video URLs, when the listing has any.

datalistingvideoUrls[]
stringoptional
datalistingfavouriteCount
integernullable

Number of people who saved the listing.

datalistingfeatured
booleannullable

Paid featured placement.

datalistingurgent
booleannullable

Marked urgent.

datalistingstandout
booleannullable

Paid highlighted card.

datalistingbumpedUp
booleannullable

Recently bumped to the top.

Who is selling. No phone number or email is returned.

datalistingsellersellerId
stringnullable

The 32-character seller id the seller endpoints take (`/v1/gumtree/sellers/{sellerId}`); null when the listing shows no profile (job ads).

datalistingsellersellerUserId
stringnullable

Seller's numeric user id, the same as `sellerUserId` on result cards. The seller endpoints don't take it.

datalistingsellername
stringnullable

Contact name as shown: a first name or a business name.

datalistingsellertype
stringnullable

`Private` or `Trade`, as the listing shows it.

datalistingsellerisTrade
booleannullable

Whether it is a business account.

datalistingsellerpostingSince
stringnullable

How long the seller has posted, as shown, e.g. `16+ years`.

datalistingsellerreplySpeed
stringnullable

Typical reply time, when shown.

datalistingsellerreplyRate
stringnullable

Reply rate, when shown.

Seller rating.

datalistingsellerratingaverage
numbernullable

Average rating out of 5; null when the seller has none.

datalistingsellerratingtotal
integernullable

Number of ratings.

Number of ratings at each star level.

datalistingsellerratingbreakdown1
integernullable
datalistingsellerratingbreakdown2
integernullable
datalistingsellerratingbreakdown3
integernullable
datalistingsellerratingbreakdown4
integernullable
datalistingsellerratingbreakdown5
integernullable
datalistingsellerratingsource
stringnullable

`gumtree` for buyer and seller reviews, `google` for a business's Google reviews.

datalistingsellerwebsiteUrl
stringnullable

Business website the listing links to, when it shows one.

Services a trade seller lists, e.g. `General Plumbing`.

datalistingsellerskills[]
stringoptional

Reviews of the seller shown on the listing (mostly trade sellers).

datalistingreviews[]reviewerName
stringnullable

Reviewer display name as shown.

datalistingreviews[]rating
numbernullable

Stars out of 5.

datalistingreviews[]date
stringnullable

When it was written, ISO 8601 UTC.

datalistingreviews[]text
stringnullable

Review text; null when none.

datalistingreviews[]source
stringnullable

`gumtree` or `google`, where the review was written.

Questions and answers on the listing, when any.

datalistingquestions[]question
stringnullable

Question.

datalistingquestions[]answer
stringnullable

Seller answer.

datalistingsimilarListingCount
integernullable

How many similar listings the page shows (see the similar endpoint).

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" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Gumtree listing.