Gumtree

List Gumtree categories

List Gumtree categories one level at a time, from the top level down.

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

API key (`sfk_...`)

Parameters
1
categoryIdstringquery

Category whose subcategories to list, e.g. `2549` (For Sale). Default: `1`, the top level.

pattern: ^\d{1,12}$

Response fields
18

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when no category has this id.

one of: found, not_found

The category asked about.

datacategoryid
string

Category or location id.

datacategoryname
string

Name as shown.

datacategoryslug
string

Slug used in URLs and in the `category` or `location` parameter.

datacategoryhasChildren
booleannullable

Whether it has children of its own; null when unknown. The category tree marks only some parents (Cars lists its makes but is not marked), so in a category's child list an unmarked node is null: pass its id to find out.

Its subcategories; empty for a leaf category.

datachildren[]id
string

Category or location id.

datachildren[]name
string

Name as shown.

datachildren[]slug
string

Slug used in URLs and in the `category` or `location` parameter.

datachildren[]hasChildren
booleannullable

Whether it has children of its own; null when unknown. The category tree marks only some parents (Cars lists its makes but is not marked), so in a category's child list an unmarked node is null: pass its id to find out.

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/categories?categoryId=2549" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Gumtree categories.