Gumtree hub

Gumtree Categories API

Walk the category tree from the top level to the leaves.

GET /v1/gumtree/categories

1 credit Failed requests are free Found, empty and not-found answers are all charged

About this endpoint

GET /v1/gumtree/categories returns data.category and its children, each with id, name, slug and hasChildren. Start with no categoryId for the top level (Motors, For Sale, Property, Jobs, Services, Pets, Community), then pass a child's id to go a level down. hasChildren is true when the site marks a category as a parent and null when it doesn't: some parents, such as Cars and its makes, go unmarked, so request a null one to find out. A leaf answers with no children.

The slug is what GET /v1/gumtree/search and GET /v1/gumtree/filters take as category. An unknown id answers lookupStatus: not_found.

Price

From $1.35 per 1,000 requests

1 credit per request. Failed requests are free.

Scale pack
$1.64 / 1,000
Growth pack
$2.36 / 1,000

The lowest rate is on annual plans; packs are pay as you go.

Example request

Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.

Request
cURL

Example response

A 200 response. Live responses have the same shape with current data.

Request
JSON

Gumtree Categories API FAQ

How do I get every category?

Start at the top level and request every child whose hasChildren is true or null, until the answers have no children.

Which value goes into search?

The slug, for example cars or bicycles, goes into the category parameter of search and filters.

Do categories change?

Rarely; responses are cached for a day.

How many credits does a request cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.