+Gumtree API
Gumtree UK ads, car and property details, trade sellers and categories as JSON.
The API.SH Gumtree API returns Gumtree UK classified ads as JSON. Search by keyword, category and location with distance, price, seller type, condition and sort, plus car filters (year, mileage, make, model, fuel, transmission, body type), property filters (bedrooms, property type) and any other filter the site offers. Open an ad for price, description, condition, photos, dates and its full details list, read a trade seller's profile with rating, reviews and live ads, and browse categories with live ad counts. Private sellers' names, phone numbers and email addresses are never returned.
- 4 endpoints
- from $1 / 1,000 calls
- 1,000 free credits / month
- failed calls free
GET https://api.api.sh/gumtree/v1/ search
{"query": "bike","page": 1,"total": 8871,"count": 29,"next_page": 2,"applied": {"category_id": 86,"location_id": 10000344,"radius": null,"location_name": "London","price_min": null,"price_max": null},"applied_filters": {"search_location": "london","search_category": "other-bikes","q": "bike","sort": "relevance"},"filters": [{"key": "featured_filter","label": "Feature ads","type": "boolean","values": []},{"key": "search_location","label": "Location","type": "enum","values": [{"value": "central-london","label": "Central London","count": 1727},{"value": "east-london","label": "East London","count": 1969},"… 7 more"]},"… 8 more"],"results": [{"id": "1804561131","url": "https://www.gumtree.com/p/other-bikes/rockrider-expl-100-mountain-bike-large-perfect-as-new-condition/1804561131","title": "Rockrider EXPL 100 Mountain Bike (Large) - Perfect (As-New) Condition","price": 219,"currency": "GBP","location": "North London, London","age": "0 days","image": "https://img.gumtree.com/ePR8PyKf84wPHx7_RYmEag/f87cd0dcad5f49fa8f_d6626b66d98a/86","image_count": 9,"seller_type": "private","verified": false,"delivery": false,"delivery_option": "collection only","promotions": ["FEATURED"],"has_video": false,"category_id": 86,"category_path_ids": [2549,2516,"… 2 more"],"attributes": [{"key": "common_for_sale_condition","name": "Condition","value": "As good as new","unit": null},{"key": "payment_option","name": "Payment Option","value": "ONLINE_PAYMENT","unit": null},"… 5 more"]},{"id": "1804573268","url": "https://www.gumtree.com/p/city-bikes/felt-road-bike-black-and-orange-good-condition/1804573268","title": "Felt Road Bike – Black and Orange, Good Condition","price": 500,"currency": "GBP","location": "Hackney, London","age": "0 days","image": "https://img.gumtree.com/ePR8PyKf84wPHx7_RYmEag/899d6c5f2f1742c9b5_8692f3173446/86","image_count": 5,"seller_type": "private","verified": false,"delivery": false,"delivery_option": "cash on collection","promotions": [],"has_video": false,"category_id": 12745,"category_path_ids": [2549,2516,"… 2 more"],"attributes": [{"key": "common_for_sale_condition","name": "Condition","value": "Good condition","unit": null},{"key": "payment_option","name": "Payment Option","value": "PAY_IN_PERSON","unit": null},"… 4 more"]},"… 27 more"],"cached": false,"credits_used": 1} What you can build with the Gumtree API
Used car price research
Search cars by make, model, year, mileage, fuel, transmission and body type within a distance of a location, and read each ad's attributes (engine, emissions, performance) to price stock or value part-exchanges.
Rental and property listing monitoring
Track property ads by location, bedrooms and property type, sorted newest first, with price, availability and photos, to follow local rents.
Resale and deal alerts
Watch a keyword and category for new ads under a price, filtered by condition and private or trade seller, or open the newest matching ad directly with latest=1.
Dealer and trade seller analysis
Profile trade sellers: years on Gumtree, rating breakdown, feedback tags, recent reviews, ad counts per category and their live stock with prices.
Local market sizing
Read categories and sub-categories with live ad counts, nationally or within a location, to size demand and supply by area.
Gumtree data you get
Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.
Gumtree API endpoints and prices
Every Gumtree endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing
| Search Gumtree UK ads /gumtree/ | $1 · $2 PAYG 1 credit |
| Gumtree trade seller /gumtree/ | $1 · $2 PAYG 1 credit |
| Gumtree UK ad details /gumtree/ | $1 · $2 PAYG 1 credit |
| Gumtree categories /gumtree/ | $1 · $2 PAYG 1 credit |
Call the Gumtree API
Search Gumtree UK ads: GET https://api.api.sh/gumtree/
curl "https://api.api.sh/gumtree/v1/search?q=bike&location=london" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/gumtree/v1/search",
params={"q": "bike", "location": "london"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/gumtree/v1/search");
url.searchParams.set("q", "bike");
url.searchParams.set("location", "london");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); # Google Sheets (API.SH add-on)
=APISH("/gumtree/v1/search", "q", "bike", "location", "london")
# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "Gumtree" and "Search Gumtree UK ads".
# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp - Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
- Create an API keyOne key works for all 918 platforms.
- Send the requestJSON back in one call. Add
output=csvoroutput=ndjsonfor files.
Why API.SH for Gumtree data
- Public data only: no Gumtree login, cookies or account needed
- One key and one response shape for Gumtree and 917 other platforms
- Built and maintained by API.SH, not third-party publishers
- Pay per call; errors on our side cost nothing
- No rate limits: run as many calls in parallel as you need
- Live status for every endpoint
API.SH vs the official Gumtree API
Gumtree UK does not publish a public API for reading ads; its partner integrations, such as delivery, are not open to developers. API.SH reads public Gumtree UK pages and returns ads, sellers and categories as JSON.
Compared with a DIY Gumtree scraper, Octoparse templates or Apify actors, API.SH gives you car and property filters as parameters, ad attributes as key/value data and seller profiles under one key, with blocks and retries handled for you.
Gumtree API questions
What Gumtree data can I get?+
Ad search with category, car and property filters (/gumtree/v1/search), one ad with its full details (/gumtree/v1/listing), a trade seller's profile, reviews and live ads (/gumtree/v1/seller) and categories with live ad counts (/gumtree/v1/categories).
How much does the Gumtree API cost?+
Every Gumtree endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.
Is there a free Gumtree API?+
Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /gumtree/v1/categories at 1 credit each.
Is there an official Gumtree API?+
Not for reading ads. Gumtree UK has no public developer API for listings. API.SH reads the public site.
Do I need a Gumtree account or login?+
No. API.SH reads public Gumtree UK pages only, never posts or messages, and never returns private sellers' names, phone numbers or email addresses.
Does it cover Gumtree Australia or South Africa?+
No. The endpoints cover Gumtree UK (gumtree.com).
How do I search Gumtree cars by make, model and mileage?+
Call /gumtree/v1/search with category set to cars and vehicle_make, vehicle_model, min_year, max_year, min_mileage, max_mileage, fuel_type, transmission or body_type, plus location and distance. The response lists the filters the page offers, with ad counts, and the ones applied.
How do I get started?+
1. Sign up at api.sh. 2. Copy your API key. 3. Call /gumtree/v1/search with q and location, then /gumtree/v1/listing with an ad id. Every parameter is in the docs at https://api.sh/docs. You can also use the JS or Python SDK, Google Sheets, Zapier, Make, n8n or the MCP server at https://api.sh/mcp.
Does the Gumtree API have a rate limit?+
No. API.SH puts no rate limit on your key: send as many Gumtree calls in parallel as you need and pay only for the calls that run. If Gumtree itself slows down, the call returns 503 with a retry-after header and is not charged.