Gumtree Seller Listings API
Everything a seller has live, a page of 25 at a time.
GET /v1/gumtree/sellers/{sellerId}/listings1 credit Failed requests are free Found, empty and not-found answers are all charged
About this endpoint
GET /v1/gumtree/sellers/{sellerId}/listings returns data.listings, 25 a page, in the same shape as search results, and data.totalListings, the listings for sale now. Each listing carries the seller's sellerId and numeric sellerUserId. Follow page.nextCursor for the next page; a cursor for another seller is refused with a 400.
An unknown seller id answers lookupStatus: not_found with an empty list.
Price
From $1.35 per 1,000 requests
1 credit per request. Failed requests are free.
- Scale pack
- $1.64 / 1,000
- Growth pack
- $2.36 / 1,000
The lowest rate is on annual plans; packs are pay as you go.
Example request
Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.
Example response
A 200 response. Live responses have the same shape with current data.
Gumtree Seller Listings API FAQ
How many listings are on a page?
Up to 25, as the profile page shows them.
Why is totalListings lower than itemsPosted on the profile?
totalListings counts what is for sale now (the profile's "items for sale"). itemsPosted on GET /v1/gumtree/sellers/{sellerId} is the selling history (the profile's "Total items"), which includes items no longer for sale.
Can I watch a trader for new listings?
Yes. Fetch the first page on a schedule and compare ids.
How many credits does a request cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth. Each paginated page is a separate billed request.
Other Gumtree endpoints
- Search listingsGET /v1/gumtree/search
- ListingGET /v1/gumtree/listings/{listingId}
- Similar listingsGET /v1/gumtree/listings/{listingId}/similar
- SellerGET /v1/gumtree/sellers/{sellerId}
- Search suggestionsGET /v1/gumtree/search/suggestions
- Trending searchesGET /v1/gumtree/trending
- CategoriesGET /v1/gumtree/categories
- Category filtersGET /v1/gumtree/filters