Gumtree

Search Gumtree listings

Search Gumtree UK listings by keyword, category, place, radius and price, with paging.

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

API key (`sfk_...`)

Parameters
8
querystringquery

Search text, e.g. `road bike`. Leave it out to browse a whole category.

min 1 chars · max 100 chars

categorystringquery

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

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

locationstringquery

Where to search: a place slug such as `london` or `manchester`, a postcode district such as `M1`, or a full postcode. Default: the whole UK.

min 1 chars · max 60 chars · pattern: ^[A-Za-z0-9][A-Za-z0-9 '&.,-]*$

distanceintegerquery

Radius in miles around `location`: 1, 3, 5, 10, 15, 30, 50, 75, 100 or 1000 (nationwide).

minPriceintegerquery

Lowest price in whole pounds, e.g. `100`.

≥ 0 · ≤ 100000000

maxPriceintegerquery

Highest price in whole pounds, e.g. `500`.

≥ 0 · ≤ 100000000

sortstringquery

`relevance`, `date` (newest first), `price_lowest_first`, `price_highest_first` or `distance` (nearest first). Default: `relevance`.

one of: relevance, date, price_lowest_first, price_highest_first, distance

cursorstringquery

Pass `page.nextCursor` from the previous response to get the next page. It only works with the same filters.

min 1 chars · max 8192 chars

Response fields
64

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when the category or location does not exist on Gumtree.

one of: found, not_found

dataquery
stringnullable

Search text, as searched.

datacategory
stringnullable

Category slug searched; null for all categories.

datalocation
stringnullable

Location the site searched, as it names it.

datatotalResults
integernullable

Number of matching listings the site reports.

A page of listings, up to about 33. The site's pages overlap: a listing an earlier page returned is not returned again, so a page can hold fewer rows than the site shows.

datalistings[]id
string

Listing id.

datalistings[]title
string

Listing title.

datalistings[]url
string

Listing URL on gumtree.com.

Asking price; null when not shown.

datalistings[]priceamount
numbernullable

Price in pounds; null when the listing shows no number.

datalistings[]pricecurrency
string

Always `GBP`.

one of: GBP

datalistings[]pricetext
stringnullable

Price as shown, e.g. `£1,450.00`; null when none is shown.

datalistings[]description
stringnullable

Start of the description, as the result card shows it.

datalistings[]postedAt
stringnullable

When the listing was posted or last bumped up, ISO 8601 UTC.

datalistings[]postedAgo
stringnullable

Age as shown, e.g. `1 day ago`.

datalistings[]location
stringnullable

Town and area as shown, e.g. `Keith, Moray`.

datalistings[]postcodeDistrict
stringnullable

Postcode district (the first half of the postcode), e.g. `AB55`.

datalistings[]locationId
stringnullable

Gumtree location id of the listing's area.

Approximate map position; only when the seller lets the listing show a map.

datalistings[]coordinateslatitude
number

Latitude.

datalistings[]coordinateslongitude
number

Longitude.

datalistings[]distance
stringnullable

Distance from the searched location as shown, e.g. `2 miles`.

datalistings[]imageUrl
stringnullable

Main photo URL.

Every photo URL the card carries.

datalistings[]imageUrls[]
stringoptional
datalistings[]imageCount
integernullable

Number of photos on the listing.

datalistings[]hasVideo
booleannullable

Whether the listing has a video.

datalistings[]categoryId
stringnullable

Leaf category id.

Category ids from the top level down to the leaf.

datalistings[]categoryIds[]
stringoptional

Attributes the listing shows (condition, brand, mileage and so on).

datalistings[]attributes[]key
string

Attribute key, e.g. `vehicle_mileage` or `seller_type`.

datalistings[]attributes[]name
string

Label as shown, e.g. `Mileage`.

datalistings[]attributes[]value
string

Value as shown, e.g. `38700`.

datalistings[]attributes[]unit
stringnullable

Unit, e.g. `miles` or `mpg`; null when none.

datalistings[]sellerId
stringnullable

The 32-character seller id the seller endpoints take. Seller listings carry it; search and similar results are null, because their cards don't: get it from the listing endpoint's `seller.sellerId`.

datalistings[]sellerUserId
stringnullable

Seller's numeric user id, as the listing's own 'other ads' link carries it. The seller endpoints don't take it: pass `sellerId`.

datalistings[]isTrade
booleannullable

Whether the seller is a business (trade) account.

datalistings[]featured
booleannullable

Paid featured placement.

datalistings[]urgent
booleannullable

Marked urgent.

datalistings[]standout
booleannullable

Paid highlighted card.

datalistings[]bumpedUp
booleannullable

Recently bumped to the top.

datalistings[]favouriteCount
integernullable

Number of people who saved the listing.

datalistings[]shippingAvailable
booleannullable

Whether the seller offers delivery.

datalistings[]status
stringnullable

Listing status, e.g. `LIVE`.

Related searches the site suggests on the page.

datarelatedSearches[]
stringoptional

Narrower categories with their match counts.

datacategories[]slug
string

Category slug.

datacategories[]name
string

Category name.

datacategories[]count
integernullable

Matching listings in that category.

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor for the next page; null on the last page.

datapagepage
integer

Page number of this response.

datapagelastPage
integernullable

Last page the site serves; null when unknown.

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/search?query=road%20bike&category=bicycles&location=london&distance=10&minPrice=100&maxPrice=500&sort=date" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Gumtree search results.