Gumtree reference
Every Gumtree operation, from the registry
9 operations wired in the registry, 9 of them proven by real traffic.
Choose a Gumtree operation
Start with the object your task needs. The groups below use the current catalogue; open an endpoint to check accepted identifiers, filters, price and availability before retrieving.
Products and categories
- Gumtree categories — The category tree, or one category's subtree.
- Gumtree listing — One listing's page: description, price, category path, location, attributes, images, the seller's profile and the seller ids the seller routes take.
- Gumtree similar listings — Listings similar to one listing.
Other operations
- Gumtree category filters — The filters a category offers, with their kinds, parameters and options.
- Gumtree location lookup — Location ids for a place name, with coordinates, for use in searches.
- Gumtree nearest location — The site's location record nearest to a coordinate.
Search and discovery
- Gumtree search — One page of Gumtree UK listings for a keyword: title, price, location, age, seller flags and URL.
- Gumtree search suggestions — Keyword suggestions for a partial search, each with the category it belongs to.
- Gumtree trending searches — The search terms trending on the site right now.
Check fields and collection limits
Use the endpoint’s declared parameters and returned continuation. Filters from another platform do not automatically apply here. Preserve source identifiers, URLs and warnings; a successful page does not establish complete history. Published response schemas identify whether they come from a reviewed shaper or observed response shapes.
Agents can use get_endpoint for the current contract and get_docs with topic platforms/gumtree to read this page. The coverage guide explains nulls and partial results, and the production guide covers budgets and recovery.
Operations
Gumtree
Each row is a registry operation: expand it for parameters, a curl built from the registry's own examples, and a Markdown copy of the whole entry. The badge on the right is the operation's state, read at request time — we publish all three rather than rounding up. Recorded proof is historical, not a guarantee of current availability.
- live · proven
- a real upstream response has been served through this API and recorded
- wired · unproven
- a real-data route is registered, but qualifying proof is absent; permission or capacity restrictions may apply
- sample · free
- no live upstream — /v1 refuses it, /sandbox returns a marked sample
Gumtree
9 operationsElsewhere
The same registry, other shapes
- Gumtree overview — supported data categories and use cases for this platform.
- Full endpoint reference — every platform on one page.
/openapi.jsonor/openapi.yaml— the machine-readable contract, for Postman, Insomnia or a client generator.GET /v1/utility/endpoints?platform=gumtree— the same rows to your code at runtime, for 0 credits.