Gumtree

Get Gumtree seller

Get a Gumtree seller profile with ratings, reviews, feedback and listing counts.

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

API key (`sfk_...`)

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

Response fields
46

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.

A Gumtree seller profile. No phone number or email is returned.

datasellersellerId
string

The 32-character seller id, as the seller endpoints take it.

datasellersellerUserId
stringnullable

Seller's numeric user id, as result cards carry it; null when the profile has no live listing to read it from.

datasellerurl
string

Profile URL on gumtree.com.

datasellername
stringnullable

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

datasellerpostingSince
stringnullable

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

datasellerlastActiveAt
stringnullable

When the seller was last active, ISO 8601 UTC.

dataselleritemsPosted
integernullable

Selling history: every item the seller has posted, live or not (the profile's "Total items"). Not the number for sale now: that is `liveListings`.

Selling history per top-level category (the profile's "Categories").

dataselleritemsPostedByCategory[]category
string

Top-level category name.

dataselleritemsPostedByCategory[]count
integer

Items posted in it, live or not.

datasellerliveListings
integernullable

Listings for sale now (the profile's "Listings: N items for sale"), the same number as `totalListings` from the seller listings endpoint.

Seller rating.

datasellerratingaverage
numbernullable

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

datasellerratingtotal
integernullable

Number of ratings.

Number of ratings at each star level.

datasellerratingbreakdown1
integernullable
datasellerratingbreakdown2
integernullable
datasellerratingbreakdown3
integernullable
datasellerratingbreakdown4
integernullable
datasellerratingbreakdown5
integernullable
datasellerratingsource
stringnullable

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

Reviews on the profile, newest first.

datasellerreviews[]reviewerName
stringnullable

Reviewer display name as shown.

datasellerreviews[]reviewerId
stringnullable

Reviewer seller id, for `/v1/gumtree/sellers/{sellerId}`.

datasellerreviews[]rating
numbernullable

Stars out of 5.

datasellerreviews[]date
stringnullable

When it was written, ISO 8601 UTC.

datasellerreviews[]reviewerRole
stringnullable

Whether the reviewer bought from or sold to this seller.

one of: buyer, seller, null

datasellerreviews[]category
stringnullable

Category of the item the review is about.

Feedback tags the reviewer picked, e.g. `Helpful`.

datasellerreviews[]feedback[]
stringoptional

Feedback tags, with how often reviewers gave each.

datasellerfeedbackSummary[]tag
string

Feedback tag, e.g. `Helpful`.

datasellerfeedbackSummary[]sentiment
stringnullable

`positive` or `negative`.

datasellerfeedbackSummary[]count
integernullable

Times it was given.

Badges the profile shows.

datasellerbadges[]
stringoptional

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

Responses

Gumtree seller profile.