Gumtree hub

Gumtree Listing API

One listing with everything its page shows logged out, except the seller's contact details.

GET /v1/gumtree/listings/{listingId}

1 credit Failed requests are free Found, empty and not-found answers are all charged

About this endpoint

GET /v1/gumtree/listings/{listingId} takes the number at the end of a listing URL, or the URL itself. data.listing carries title, description, price, postedAt, createdAt, updatedAt, images, videoUrls, attributes (condition, brand, mileage, fuel, bedrooms and so on), location, town, area, postcodeDistrict, categoryPath, favouriteCount, the paid flags and, on vehicles that show one, historyCheck (the write-off, import, plate and colour checks; never the plate itself).

listing.seller has sellerId, the 32-character id the seller routes take, and sellerUserId, the numeric id result cards carry, the name the listing shows, type (Private or Trade), rating, postingSince and, for traders, skills and websiteUrl. listing.reviews holds the reviews the page shows. An expired or removed listing answers lookupStatus: not_found.

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.

Request
cURL

Example response

A 200 response. Live responses have the same shape with current data.

Request
JSON

Gumtree Listing API FAQ

Does it return the seller's phone number?

No. Gumtree keeps phone numbers behind a login, so neither phone numbers nor emails are returned. The seller id leads to the seller's profile and listings.

Can I pass the listing URL?

Yes. Pass the URL, encoded, as listingId and the id is taken from its end. The plain number works too.

What does not_found mean for a listing?

The listing has expired, was removed, or never existed; Gumtree answers all three the same way. data.listing is null.

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.