> **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/sellers-sellerid-listings>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/gumtree/sellers-sellerid-listings.mdx>

---

# Gumtree Seller Listings API

Everything a seller has live, a page of 25 at a time.

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

## Request

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

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