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

---

# Gumtree Filters API

Every filter a category's search page offers, with its options.

`GET /v1/gumtree/filters?category=cars` returns `data.filters` in the order the site shows them, each with `key`, `label`, `type`, `options` (value, label and count across the UK) and, for ranges, `minOptions`, `maxOptions`, `minKey` and `maxKey`. `data.sortOptions` and `data.distanceOptions` list the sort orders and search radii.

An unknown category slug answers `lookupStatus: not_found`.

## Request

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

## FAQ

### What filter types are there?

enum (pick one), multiple_selection, boolean switches, enum_range (low and high picked from lists, such as mileage) and range_freeform (any numbers, such as price).

### Can I use these filters in search?

Search takes category, location, distance, minPrice, maxPrice and sort. The other filters describe the category and its counts.

### Are the counts live?

They are the counts the category's page shows across the UK; responses are cached for an hour.

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