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

---

# Gumtree Search API

The listings Gumtree shows for a search, up to about 33 a page, with totals and narrower categories.

`GET /v1/gumtree/search` takes `query`, `category` (a slug such as `cars`), `location` (a place slug, a postcode district or a full postcode), `distance` in miles, `minPrice`, `maxPrice` and `sort`. Pass a query, a category, or both. Each listing has `id`, `title`, `url`, `price`, the start of its `description`, `postedAt`, `location`, `postcodeDistrict`, photos, attributes, `isTrade`, `featured` and `favouriteCount`.

`data.totalResults` is the number of matches the site reports, `data.categories` the narrower categories with their counts and `data.relatedSearches` the related searches the page suggests. Follow `page.nextCursor` with the same filters, up to page 50. An unknown category or place slug answers `lookupStatus: not_found`.

## Request

- **Endpoint:** `GET /v1/gumtree/search`
- **Credits:** 1 credit
Failed requests are free
Found, empty and not-found answers are all charged
- **Input:** by keyword, category and location
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/gumtree/search/get)
- **Platform page:** [/platforms/gumtree](https://www.socialfetch.dev/platforms/gumtree)

## FAQ

### Can I search one town or postcode?

Yes. Set location to a place slug such as london or manchester, a postcode district such as M1, or a full postcode, and add distance in miles for a radius. Use GET /v1/gumtree/locations to find the right place.

### How do I sort by price or date?

Set sort to date for the newest first, price_lowest_first or price_highest_first for price, or distance for the nearest first when you give a location. The default is relevance.

### Why does a featured listing appear on page 1?

Featured listings are paid placements the site mixes into the results; they carry featured: true. A listing shown on one page is never repeated on the next page you fetch with the cursor.

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