Gumtree

Search Gumtree locations

Search Gumtree locations by place name, postcode district or postcode.

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

API key (`sfk_...`)

Parameters
1
querystringrequiredquery

Start of a place name or postcode, e.g. `manch`, `M1` or `SW1A 1AA`.

min 1 chars · max 60 chars

Response fields
15

Endpoint-specific response payload.

dataquery
string

Text the locations match.

Matching locations, best first. Empty when none match.

datalocations[]id
string

Gumtree location id.

datalocations[]name
string

Name as shown, e.g. `Manchester City Centre, Manchester`.

datalocations[]type
stringnullable

`location`, `outcode` (postcode district) or `postcode`.

datalocations[]city
stringnullable

Town or county it belongs to.

datalocations[]latitude
numbernullable

Latitude of its centre.

datalocations[]longitude
numbernullable

Longitude of its centre.

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/locations?query=manch" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Gumtree locations.