List Gumtree seller listings
List a Gumtree seller's live listings, 25 a page, with paging.
Headers
Get your API keyAPI key (`sfk_...`)
Gumtree seller id: the 32-character id in the seller's profile URL (`gumtree.com/profile/account/<sellerId>`), also returned as `seller.sellerId` on a listing and as `sellerId` on a seller's listings. Not the numeric `sellerUserId`.
pattern: ^[0-9a-f]{32}$
Pass `page.nextCursor` from the previous response to get the next page. It only works with the same filters.
min 1 chars · max 8192 chars
Endpoint-specific response payload.
`not_found` when no seller has this id.
one of: found, not_found
Seller id, as requested.
Listings for sale now, across every page (the profile's "Listings: N items for sale"). Not the selling history: that is `itemsPosted` on the seller endpoint.
A page of the seller's live listings, up to 25.
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`.
Pagination state for the current page.
Whether another page is available.
Cursor for the next page; null on the last page.
Page number of this response.
Last page the site serves; null when unknown.
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/sellers/025e99f5bb366d130f2e02f5b7adab9a/listings" \
-H "x-api-key: YOUR_API_KEY"Responses
Gumtree seller listings.