Gumtree API. Listings, sellers and search.
Search UK classifieds the way the site does, read any public listing with its photos and attributes, look up the seller behind it, and walk the category and location trees. JSON in, JSON out.
- UK classifieds
- Listings and sellers
- Category filters
- Failed requests aren't charged
Teams running monitoring, research, and enrichment pipelines
Why Social Fetch
Gumtree data as JSON. You build the product.
Live Gumtree data in one response shape, with platform changes handled for you.
Gumtree, plus every other platform
One key and one response envelope for Gumtree and 86 more platforms.
API key
sk_live_••••••••
Pricing you can reason about
One request, one credit. Know how far your balance will go before you run your next batch.
- Requests
- 480
- Credits
- 480
Balance
Live data on every request
Fetch public data when you ask for it.
Nothing to maintain
We handle platform changes and breakages.
Built for production jobs
Run concurrent workloads with explicit statuses and request IDs.
lookupStatus: found
Regular jobs. Better rates.
Running lookups every month? Get lower per-credit rates with a monthly plan. For occasional projects, choose pay as you go.
What Gumtree data can you get?
11 endpoints, one API key. Every response comes back as live JSON in the same envelope.
Listings
Sellers
Discovery
Locations
Browse all 11 Gumtree endpoints
Listings
Sellers
Discovery
Locations
Example request
GET /v1/gumtree/search. 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.
What teams build with Gumtree data
Monitoring, enrichment, research and content workflows on Gumtree data, on the same API as every other platform.
How it works
Your first request in three steps.
Use TypeScript or your automation tool of choice.
API key
sfk_live_••••••••••••
Free requests100
Step 1: Create your free account
Get an API key with 100 requests included.
GET/v2/instagram/profiles/charlidamelio
1 request · 1 credit
Step 2: Choose an endpoint
Pass a username, URL, keyword, or post ID.
200 OK1.82s
{
"handle": "charlidamelio",
"displayName": "Charli D'Amelio",
"followers": 48300000,
"following": 1284
}
Step 3: Get clean JSON
Use the response immediately or send it into your pipeline.
Works with your stack
Code, automate, or connect your AI.
Pricing
Social data, priced simply.
Start with 100 free credits. Monthly plans give you predictable volume and lower per-request rates.
Starter
18,000credits
$1.61 per 1k · $0.00161 per request
- Top up from $1.61 / 1k if you run out
- Up to 25 monitors
Growth
50,000credits
$1.58 per 1k · $0.00158 per request
- Top up from $1.58 / 1k if you run out
- 5 team seats
- Up to 100 monitors
Scale
150,000credits
$1.50 per 1k · $0.00150 per request
- Top up from $1.50 / 1k if you run out
- 25 team seats
- Up to 250 monitors
- Cancel anytime
- 30-day money-back guarantee
- Price locked while you stay
Need 1M+ credits, invoicing, or volume rates? Talk to us
Trust signals
DevHunt
Product Hunt
Uneed
Customers
Teams building on Social Fetch.
“Our TikTok and Instagram scrapers broke constantly. Social Fetch took us off that rotation — we ship product again.”
“A maker pastes one link and Social Fetch fills in their bio and socials. Most of inko runs on it, and it just works.”
Jade P. · Founder, inko “Live profile data on every request. We never flag accounts from a stale cache.”
Hannah Webb · Founder, Scam Finder “Heavy concurrent load, no rate limits to negotiate. The rare API I haven't wrapped in retries.”
Owen Pritchard · Founder, IP Flare
Gumtree API: common questions
Is there a Gumtree API for listings and search?
Yes. Social Fetch has eleven Gumtree UK routes under /v1/gumtree: search, a listing, similar listings, a seller, a seller's listings, search suggestions, trending searches, categories, category filters, location search and location areas. Authenticate with your Social Fetch API key in x-api-key.
How do I find a listing id?
It is the number at the end of a listing URL, for example 1495075116 in gumtree.com/p/plumbing-services/.../1495075116. Pass the number or the whole URL. Search results carry the id of every listing they return.
Which search filters are supported?
query, category (a slug such as cars, bicycles or property-to-rent), location (a place slug, a postcode district or a full postcode), distance in miles (1, 3, 5, 10, 15, 30, 50, 75, 100 or 1000), minPrice and maxPrice in whole pounds, and sort (relevance, date, price_lowest_first, price_highest_first or distance). GET /v1/gumtree/filters lists every filter a category offers with its options.
Does the API return seller phone numbers or emails?
No. Gumtree keeps phone numbers behind a login and relays messages without showing an email, so neither is returned. A listing carries the seller name it shows (a first name or a business name), whether the seller is private or trade, their rating, how long they have posted and the seller id for the seller routes.
How precise is a listing's location?
Listings return the town and area the page shows, for example Keith, Moray, the postcode district such as AB55, and a Gumtree location id. Map coordinates are returned only when the seller lets the listing show a map. A full postcode is never returned.
How does paging work?
Search and seller listings return page.hasMore and page.nextCursor. Pass the cursor back with the same filters to get the next page; a cursor used with other filters is refused with a 400. Search serves up to 50 pages, and a listing shown on one page is never repeated on the next.
What happens when a listing has expired?
The response is HTTP 200 with data.lookupStatus not_found and data.listing null. Gumtree answers the same way for a listing that never existed, so the two cannot be told apart. The lookup is still charged, like any completed request.
How is Gumtree data billed?
Each completed request costs 1 credit, found, empty or not found, and each page of a list is a separate request. Check meta.creditsCharged on every response. Failed requests are free.
Can I use the Gumtree routes from MCP or Ask?
Yes. Every Gumtree route is a typed MCP tool and is reachable through Ask (POST /v1/ask) in plain English. Use the typed routes for production jobs, where the parameters and response shape are fixed.
The Gumtree API in detailHow the Gumtree routes work, what they cost, and how they differ from the official API.
Why teams use Social Fetch for Gumtree
Social Fetch exposes eleven routes under /v1/gumtree for Gumtree UK. GET /v1/gumtree/search takes a query, a category slug such as cars or bicycles, a location (a place slug such as london, a postcode district such as M1, or a full postcode), a distance in miles, minPrice, maxPrice and sort, and returns up to about 33 listings a page with totalResults, related searches and match counts per category. Follow page.nextCursor for the next page, up to the 50 pages the site serves.
GET /v1/gumtree/listings/{listingId} returns one listing with its full description, price, images, videoUrls, every attribute (condition, brand, mileage, bedrooms and so on), the town, area and postcode district, its category path, the seller (name, private or trade, rating, posting since) and any reviews it shows. .../similar returns the similar listings the page shows. The listing id is the number at the end of a listing URL, and the full URL is accepted too.
GET /v1/gumtree/sellers/{sellerId} returns a seller's profile, rating breakdown, reviews and feedback tags, and .../listings pages through their live listings. Discovery routes cover search suggestions, trending searches by area, the category tree, the filters of a category, location autocomplete and the location tree. Every response uses the { data, meta } envelope; lookups set data.lookupStatus to found or not_found.
How to call the Gumtree API
1. Create an API key
Sign up at Social Fetch and copy a key (
sfk_…). New accounts get 100 free credits, enough to try search, a listing and a seller.2. Search or look up
GET /v1/gumtree/search?query=road%20bike&location=london&distance=10returns a page of listings. Take a listing'sidtoGET /v1/gumtree/listings/{listingId}and itsseller.sellerIdtoGET /v1/gumtree/sellers/{sellerId}. Sendx-api-keyon every request.3. Branch and page
Check
data.lookupStatusbefore you store a row, followpage.nextCursorwith the same filters, and bill frommeta.creditsCharged.
What each Gumtree route returns
- Search with keyword, category, place, radius, price range and five sort orders, with stable paging that never repeats a listing.
- Full listings: description, price, photos, video, every attribute, location to the postcode district, category path and seller.
- Seller profiles with rating breakdown, reviews, feedback tags, listing counts by category and live listings.
- Similar listings for any listing, as the listing page shows them.
- Search suggestions as the search box offers them, and the searches trending across the UK or in one area.
- Category and location trees, location autocomplete for places and postcodes, and the filters, sort orders and radius options of any category.
How much does the Gumtree API cost?
Every Gumtree route costs 1 credit per completed request, found, empty or not found. Each page of search results or seller listings is its own request. Failed requests are free. Credits never expire on pay-as-you-go packs, and meta.creditsCharged on every response is the billing source of truth.
Social Fetch vs the official Gumtree API
Gumtree has no public API for listings or sellers. Social Fetch gives you one JSON shape under /v1/gumtree: typed prices in pounds, ISO timestamps, attributes as key, label, value and unit, not_found for expired or removed listings, and cursors that keep paging stable. Personal contact details stay out: no phone numbers or emails, and locations go no finer than the postcode district.
Pull your first Gumtree data.
Run a live Gumtree request in the playground. 100 free credits, no card, JSON back in seconds.
No credit cardSign up in 30 seconds withGoogleGitHub
