Gumtree

List Gumtree seller listings

List a Gumtree seller's live listings, 25 a page, with paging.

GET/v1/gumtree/sellers/{sellerId}/listings
x-api-keystringheader

API key (`sfk_...`)

Parameters
2
sellerIdstringrequiredpath

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}$

cursorstringoptionalquery

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

Response fields
56

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when no seller has this id.

one of: found, not_found

datasellerId
string

Seller id, as requested.

datatotalListings
integernullable

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.

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

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor for the next page; null on the last page.

datapagepage
integer

Page number of this response.

datapagelastPage
integernullable

Last page the site serves; null when unknown.

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/sellers/025e99f5bb366d130f2e02f5b7adab9a/listings" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Gumtree seller listings.