Gumtree API

Search Gumtree UK ads for cars, property and more, and pull full ad details and trade seller profiles as JSON.

The API.SH Gumtree API turns public Gumtree UK pages into structured JSON. Search ads by keyword, category and location with distance, price, seller type, condition and sort, plus car filters (year, mileage, make, model, fuel, transmission, body type) and property filters (bedrooms, property type). Open any ad for its description, photos, dates and full details list, and read a trade seller's profile with rating, reviews, ad counts and live ads. Private sellers' names, phone numbers and emails are never returned.

Get a free API key Try it in the playground

3 endpoints
from $1 / 1,000 calls
1,000 free credits / month
failed calls free

Search Gumtree UK ads

GET https://api.api.sh/gumtree/v1/search

{ "success": true }

1 credit · $1 per 1,000 calls

What you can build with the Gumtree API

Used car market data

Search cars by make, model, year, mileage and fuel in an area, then open ads for engine, emissions and performance details to price stock or spot deals.

/search /listing

Rental and property research

Collect property ads by bedrooms and property type in a town to track asking rents and availability.

/search /listing

New ad alerts

Call the listing endpoint with latest=1 and your search terms to get the newest matching ad and alert as soon as it is posted.

/listing

Dealer and trade seller research

Read a trade seller's rating, feedback, ad counts by category and live stock to benchmark dealers and competitors.

/seller

Resale price research

Search a category by condition and price to see what second-hand items sell for near you.

/search

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 and discovery1

Search Gumtree UK ads

/gumtree/v1/search

$1 · $2 PAYG

1 credit

Profiles and accounts1

Gumtree trade seller

/gumtree/v1/seller

$1 · $2 PAYG

1 credit

Products, listings and places1

Gumtree UK ad details

/gumtree/v1/listing

$1 · $2 PAYG

1 credit

Call the Gumtree API

Search Gumtree UK ads: GET https://api.api.sh/gumtree/v1/search

curl "https://api.api.sh/gumtree/v1/search?q=bike" \
  -H "x-api-key: $APISH_KEY"

import os, requests

res = requests.get(
    "https://api.api.sh/gumtree/v1/search",
    params={"q": "bike"},
    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");

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")

# 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 482 platforms.
Send the requestJSON back in one call. Add output=csv or output=ndjson for 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 481 other platforms
Built and maintained by API.SH, not third-party publishers
Pay per call; errors on our side cost nothing
Live status for every endpoint

API.SH vs the official Gumtree API

Gumtree does not offer an open public API for reading ads; its terms only say an API may be made available on Gumtree's own conditions. API.SH reads public Gumtree UK pages and returns ads and trade seller profiles as JSON, with no account.

Rather than running your own Gumtree scraper or choosing among Apify actors per category, API.SH gives you search, ads and sellers with one key and a fixed price per call.

Gumtree API questions

What Gumtree data can I get?+

Ad search with car, property and general filters (/gumtree/v1/search), one ad with description, photos, dates and full details list (/gumtree/v1/listing) and trade seller profiles with rating, reviews and live ads (/gumtree/v1/seller).

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/listing at 1 credit each.

Is there an official Gumtree API?+

Not an open one for reading ads. API.SH is an independent way to read public Gumtree UK ads and trade seller pages as JSON.

Do I need a Gumtree account or login?+

No. API.SH reads public ads only. No endpoint uses a login or anyone's account, and private sellers' names, phone numbers and email addresses are never returned.

Does it cover Gumtree Australia or South Africa?+

No. The API.SH Gumtree API covers Gumtree UK only.

Can I search used cars by make, model and mileage?+

Yes. /gumtree/v1/search takes vehicle_make, vehicle_model, min_year, max_year, min_mileage, max_mileage, fuel_type, transmission and body_type, and each result includes those details in attributes.

How do I get started?+

1. Sign up at api.sh. 2. Copy your API key. 3. Call /gumtree/v1/search with q, category and location, for example a car model in London. 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.