All platforms11 Gumtree endpoints

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.

No credit card requiredRead the API docs
  • UK classifieds
  • Listings and sellers
  • Category filters
  • Failed requests aren't charged
99.8% uptime#3 Product of the Day3,200+ developers

Teams running monitoring, research, and enrichment pipelines

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.

Just now1h ago

Nothing to maintain

We handle platform changes and breakages.

Built for production jobs

Run concurrent workloads with explicit statuses and request IDs.

req_8f42200
req_a91c200
req_3e07200
req_d5b8200

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.

MonthlyLower rate
Pay as you go

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.

Request
cURL

Example response

A 200 response. Live responses have the same shape with current data.

Request
JSON
Use cases

What teams build with Gumtree data

Monitoring, enrichment, research and content workflows on Gumtree data, on the same API as every other platform.

Watch a market

Track prices and new listings for a search, a category or a town.

Research sellers

Read a trader's profile, reviews and live listings.

How it works

Your first request in three steps.

Use TypeScript or your automation tool of choice.

  1. API key

    sfk_live_••••••••••••

    Free requests100

    Step 1: Create your free account

    Get an API key with 100 requests included.

  2. GET/v2/instagram/profiles/charlidamelio

    1 request · 1 credit

    Step 2: Choose an endpoint

    Pass a username, URL, keyword, or post ID.

  3. 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.

Explore integrations

Pricing

Social data, priced simply.

Start with 100 free credits. Monthly plans give you predictable volume and lower per-request rates.

Starter

$29.00

18,000credits

  • Top up from $1.61 / 1k if you run out
  • Up to 25 monitors
Most popular

Growth

$79.00

50,000credits

  • Top up from $1.58 / 1k if you run out
  • 5 team seats
  • Up to 100 monitors

Scale

$225.00

150,000credits

  • 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.”

Daniel Reeve · Founder, Social Crow
  • “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. 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. 2. Search or look up

    GET /v1/gumtree/search?query=road%20bike&location=london&distance=10 returns a page of listings. Take a listing's id to GET /v1/gumtree/listings/{listingId} and its seller.sellerId to GET /v1/gumtree/sellers/{sellerId}. Send x-api-key on every request.

  3. 3. Branch and page

    Check data.lookupStatus before you store a row, follow page.nextCursor with the same filters, and bill from meta.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