Gumtree Categories API
Walk the category tree from the top level to the leaves.
GET /v1/gumtree/categories1 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.
Example response
A 200 response. Live responses have the same shape with current data.
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.
Other Gumtree endpoints
- Search listingsGET /v1/gumtree/search
- ListingGET /v1/gumtree/listings/{listingId}
- Similar listingsGET /v1/gumtree/listings/{listingId}/similar
- SellerGET /v1/gumtree/sellers/{sellerId}
- Seller listingsGET /v1/gumtree/sellers/{sellerId}/listings
- Search suggestionsGET /v1/gumtree/search/suggestions
- Trending searchesGET /v1/gumtree/trending
- Category filtersGET /v1/gumtree/filters