Gumtree

Get Gumtree category filters

Get the search filters, sort orders and radius options of a Gumtree category.

GET/v1/gumtree/filters
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
categorystringrequiredquery

Category slug, e.g. `cars`, `bicycles` or `property-to-rent` (the `slug` from the categories endpoint).

min 1 chars · max 80 chars · pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$

Response fields
32

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when no category has this slug.

one of: found, not_found

datacategory
string

Category slug, as requested.

datacategoryName
stringnullable

Category name, e.g. `Cars`.

Filters the category offers, in the order the site shows them.

datafilters[]key
string

Filter key as the site names it, e.g. `vehicle_make` or `price`.

datafilters[]label
stringnullable

Label as shown.

datafilters[]type
stringnullable

`enum` (pick one), `multiple_selection`, `boolean`, `enum_range` (low and high picked from lists) or `range_freeform` (any numbers).

Options to pick from; empty for a free range or a switch.

datafilters[]options[]value
string

Value to filter on.

datafilters[]options[]label
string

Label as shown.

datafilters[]options[]count
integernullable

Listings with this value across the UK, when shown.

Values offered for the low end of an `enum_range` filter.

datafilters[]minOptions[]value
string

Value to filter on; empty for no limit.

datafilters[]minOptions[]label
string

Label as shown, e.g. `£1,000`.

Values offered for the high end of an `enum_range` filter.

datafilters[]maxOptions[]value
string

Value to filter on; empty for no limit.

datafilters[]maxOptions[]label
string

Label as shown, e.g. `£1,000`.

datafilters[]minKey
stringnullable

Parameter for the low end of a range, e.g. `min_price`.

datafilters[]maxKey
stringnullable

Parameter for the high end of a range, e.g. `max_price`.

Ways the results can be sorted.

datasortOptions[]value
string

Sort value.

datasortOptions[]label
string

Label as shown.

Search radius choices.

datadistanceOptions[]value
number

Radius in miles.

datadistanceOptions[]label
string

Label as shown.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.

one of: true

metafetchedAt
stringoptional

When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.

Code example

curl "https://api.socialfetch.dev/v1/gumtree/filters?category=cars" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Gumtree category filters.