Skip to main content
GET
List Categories
Browse Gumtree’s category tree one level at a time. On uk and au each child’s slug is the value /search and /search/filters take as category — a name slug on uk (cars), the numeric id on au (18320). On za pass the child’s id, a ref such as p6dnh (Cars & Bakkies). Credits: 1

Authorization

string
required
Your ScrapeBadger API key.

Query Parameters

string
default:"uk"
uk (gumtree.com), au (gumtree.com.au) or za (gumtree.co.za).
string
Category id (uk, au: a number) or ref (za) to list the children of. Omit it for the market’s root — all categories (uk root id 1, au root id 0 with 16 top-level categories, za root ref kyzkk with 17). Then drill down by id, e.g. 2551 for UK Motors, 9299 for AU Cars & Vehicles, l4dq6 for ZA Vehicles.

Response

string
uk, au or za.
integer | string
The parent category id — a ref string on za.
string
e.g. Motors.
string
e.g. cars-vans-motorbikes.
integer
Number of children.
TreeNode[]
Child categories.

Example

Response

South Africa

Response (abridged)
Pass p6dnh as category to /search?market=za — the slug (cars-bakkies) is the site’s URL segment, not the value /search takes. On au, parent_id=9299 (Cars & Vehicles) lists 18320 (Cars, Vans & Utes) among its children.

Errors