> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/gumtree/listings-listingid>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/gumtree/listings-listingid.mdx>

---

# Gumtree Listing API

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

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

## Request

- **Endpoint:** `GET /v1/gumtree/listings/{listingId}`
- **Credits:** 1 credit
Failed requests are free
Found, empty and not-found answers are all charged
- **Input:** by listing id or URL
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/gumtree/listings/listingid/get)
- **Platform page:** [/platforms/gumtree](https://www.socialfetch.dev/platforms/gumtree)

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