Ecommerce Scraper API

Gumtree Scraper API for UK Classifieds, Cars and Seller Data

Extract structured Gumtree data for UK price tracking, vehicle and property research and seller analysis. Search every category by keyword, postcode and radius, retrieve complete listings with the full vehicle spec for cars, and map seller inventories without managing proxies or parsers.

1,000 free credits
No credit card required

Use the same API key and credit balance across every ScrapeBadger API.

GET /v1/gumtree/search
{
  "category_name": "Cars",
  "location_name": "United Kingdom",
  "total_results": 139812,
  "listings": [
    {
      "id": "1803479690",
      "title": "Mitsubishi, OUTLANDER, Estate, 2015, Other, 1998 (cc), 5 doors",
      "price": 4500.0,
      "currency": "GBP",
      "location": "London",
      "postcode": "NW107JD",
      "posted_at": "2026-10-04T10:32:04.168000Z",
      "seller_type": "Private",
      "is_featured": true
    }
  ]
}
Endpoints

Explore All 8 Gumtree API Endpoints

Search UK classifieds, discover category filters, retrieve complete listing and seller data, and resolve categories and locations through structured JSON responses.

  1. Search
  2. Listing details
  3. Seller insights
  4. Structured JSON
GET/v1/gumtree/search5 credits

Search Listings

Search Gumtree UK classifieds across every category. Combine keywords with a category, a town or UK postcode plus a radius in miles, a price range, seller type, urgent-only and with-photos flags, and category-specific filters such as make, fuel type or mileage. Each page returns about 25–30 listings.

Optional Parameters: query, category, location, distance, min_price, max_price, sort, seller_type, urgent_only, with_photos, filters, page

Request
curl --get \
  'https://scrapebadger.com/v1/gumtree/search' \
  --data-urlencode 'category=cars' \
  --data-urlencode 'location=uk' \
  --data-urlencode 'sort=relevance' \
  --data-urlencode 'page=1' \
  --header 'X-API-Key: YOUR_API_KEY'
Response200 OK
{
  "query": null,
  "category": "cars",
  "category_name": "Cars",
  "category_id": 9311,
  "location": "uk",
  "location_name": "United Kingdom",
  "sort": "relevance",
  "page": 1,
  "total_pages": 50,
  "total_results": 139812,
  "result_count": 30,
  "listings": [
    {
      "id": "1803479690",
      "title": "Mitsubishi, OUTLANDER, Estate, 2015, Other, 1998 (cc), 5 doors",
      "url": "https://www.gumtree.com/p/mitsubishi/mitsubishi-outlander-estate-2015-other-1998-cc-5-doors/1803479690",
      "description": "MITSUBISHI OUTLANDER PHEV GX4\n2015 Petrol 2.0L Automatic 5 doors Estate\nNice family car.. driving is really amazing.fully serviced and changed new tyr...",
      "price": 4500.0,
      "price_text": "£4,500.00",
      "price_frequency": null,
      "currency": "GBP",
      "location": "London",
      "location_id": "10000344",
      "postcode": "NW107JD",
      "latitude": 51.530848,
      "longitude": -0.282636,
      "distance_text": "88 miles",
      "distance_miles": 88.0,
      "category_id": 10316,
      "category_name": "Mitsubishi",
      "category_ids": [
        2551,
        9311,
        10316
      ],
      "image_url": "https://img.gumtree.com/ePR8PyKf84wPHx7_RYmEag/ff96d1746579438497_035587c5abe9/86",
      "image_urls": [
        "https://img.gumtree.com/ePR8PyKf84wPHx7_RYmEag/ff96d1746579438497_035587c5abe9/86"
      ],
      "image_count": 7,
      "posted_text": "7 days ago",
      "posted_utc": 1791109924.168,
      "posted_at": "2026-10-04T10:32:04.168000Z",
      "status": "LIVE",
      "seller_type": "Private",
      "seller_id": "103262444",
      "account_id": "102719651",
      "is_pro_seller": false,
      "is_featured": true,
      "is_urgent": false,
      "is_bumped_up": false,
      "is_standout": false,
      "is_premium": false,
      "has_video": false,
      "supports_shipping": false,
      "favourite_count": 1,
      "attributes": [
        {
          "key": "vehicle_make",
          "label": "Make",
          "value": "Mitsubishi",
          "unit": null
        },
        {
          "key": "vehicle_model",
          "label": "Model",
          "value": "OUTLANDER",
          "unit": null
        },
        {
          "key": "vehicle_registration_year",
          "label": "Year",
          "value": "2015",
          "unit": null
        },
        {
          "key": "vehicle_mileage",
          "label": "Mileage",
          "value": "123000",
          "unit": "miles"
        },
        {
          "key": "vehicle_fuel_type",
          "label": "Fuel type",
          "value": "Hybrid Electric",
          "unit": null
        },
        {
          "key": "vehicle_not_stolen",
          "label": "Not stolen",
          "value": "true",
          "unit": null
        },
        {
          "key": "vehicle_not_writeoff",
          "label": "Not written-off",
          "value": "true",
          "unit": null
        },
        {
          "key": "vehicle_previous_keepers",
          "label": "Previous Keepers",
          "value": "3",
          "unit": null
        }
      ]
    }
  ],
  "url": "https://www.gumtree.com/search?search_category=cars&search_location=uk"
}
View Search Listings documentation
200
Request completed successfully
400
A `filters` value is not in key:value form
401
API key is missing or invalid
402
The account does not have enough credits
404
The listing does not exist or is no longer live
422
A required parameter is missing or invalid
429
The plan’s request limit has been reached

What Can You Build With the Gumtree Scraper API?

Used Car Pricing and Stock Analysis

Track asking prices, mileage, age and specification for any make and model across the UK. Compare private and trade supply, spot underpriced vehicles and monitor dealer stock levels over time.

Search ListingsGet Search FiltersGet Listing Detail

Local Market and Rental Monitoring

Follow rents, sale prices and new supply around any town or postcode. Combine category, radius and price filters to build local market indices for property, jobs, services or second-hand goods.

Search ListingsLocation AutocompleteList LocationsList Categories

Seller and Dealer Intelligence

Profile private sellers, dealers and agencies by verification status, rating, activity and inventory. Map a trade seller's full catalogue from any of their listings and monitor competing dealers.

Get Listing DetailGet Seller Listings

Classifieds Aggregation and Alerts

Build alerts and feeds for newly posted, urgent or price-dropped listings in the categories and areas you care about, and enrich search boxes with Gumtree's own keyword suggestions.

Search ListingsSearch AutocompleteGet Listing Detail
Sign Up For Free

1,000 free credits · No credit card required

Explore More E-commerce Scraper APIs

Connect Gumtree data with other marketplace sources through the same ScrapeBadger account, API key and credit balance.

Why Choose ScrapeBadger?

Build Faster

Get normalized Gumtree data without building parsers, managing proxy pools or maintaining selectors. Start with REST or an official SDK and ship faster.

Scale Confidently

Session handling, retries and UK routing are managed for you, so your pipeline keeps running when the site changes. Check live uptime on the API status page.

Complete Gumtree Data in One API

Use 8 dedicated endpoints to search listings, discover category filters, retrieve listing and seller details, and resolve UK categories and locations.

Integrate Anywhere

Connect through a REST API, 12 official SDKs or ScrapeBadger's MCP server. Responses use consistent structured JSON.

Integrate With Your Stack

Use ScrapeBadger through an official SDK, a standard API request or the tools already in your workflow.

Python SDK

Search Gumtree listings, retrieve listing details and analyze sellers with typed methods and structured response objects.

Node.js SDK

Add Gumtree classifieds, vehicle, pricing and seller data to Node.js or TypeScript applications with an official SDK.

REST API

Connect from any backend or programming language using standard HTTP requests and receive structured JSON responses.

12 Official SDKs

Use official clients for Python, TypeScript, Go, Rust, PHP, C#, Java, Kotlin, Ruby, Swift, Dart and C++.

MCP for AI Tools

Connect ScrapeBadger to Claude, ChatGPT, Cursor and other MCP-compatible tools through typed tools with structured parameters and responses.

One API Key

Access Gumtree and ScrapeBadger's other supported marketplace APIs through one account, API key and shared credit balance.

Trusted by Developers Worldwide

See what customers say about ScrapeBadger.

“Awesome scraper! we've used it to analyse products to launch for a ecom analytics company. probably will use further; also used their Amazon product and search scrapers.”

MR
MRiabov
Apify Store review
18 June 2026

“Perfect for my small SAAS, couldnt get vinted working but they do!”

NE
Nebulus
Trustpilot review · Spain
3 September 2026

“Fantastic service - been using this for over 6 months and hasn't failed me ONCE. They are consistently bringing out new scrapers and the prices are the cheapest ive seen on the market. Definitely recommended!”

PY
P Yam
Trustpilot review · United Kingdom
25 September 2026

“Looked for a scraper for multiple platforms to integrate in my projects, ScrapeBadger simply worked for everything I needed. Also integrating the API in my code was a breeze thanks to provided documentation.”

DV
Daniel Varan
Trustpilot review · Romania
8 July 2026

“It is the simplest scraper I ever tried, simple yet effective. simple end points, direct and straighforward. affordable. without doubt : it is a winner. application is easy to use and to connect to your database. service is amazing.”

EA
Emran Andraos
Trustpilot review · Saudi Arabia
10 September 2026

“really easy to use, excellent integration and plenty of free credits meant I was able to test and validate what I wanted without spending money. Great service!”

AT
Alan Tweddell
Trustpilot review · United Kingdom
8 September 2026
Pricing

Simple, transparent pricing

Pay As You Go from $10 or save with a monthly or annual subscription. Every Gumtree endpoint is available on every plan.

Not Sure Which Plan Fits Your Needs? Calculate Your Cost and Find the Right Plan.

Choose a Gumtree endpoint and enter the number of successful requests you expect to make. Failed requests cost 0 credits.

FAQ

Frequently asked questions

Everything you need to know about the Gumtree Scraper API.

What data can I retrieve with the Gumtree Scraper API?

Search results include the listing ID, title, URL, description snippet, price in GBP, location, postcode and coordinates, distance, category, images, posted date, seller type and promotion flags such as featured, urgent and bumped up. Get Listing Detail adds the full description, every attribute, all images, VAT status, created, updated and expiry dates, the seller profile and similar listings.

Which Gumtree categories are covered?

Every vertical on gumtree.com: For Sale, Motors (cars, vans, motorbikes), Property (to rent, for sale and flatshares), Jobs, Services, Pets and Community. Use List Categories to browse the category tree, then pass any child slug, such as cars, property-to-rent or bicycles, as the category search parameter.

Can I search around a UK postcode?

Yes. Set location to a town or location slug (for example london) or to a full UK postcode such as SW1A 1AA, then add distance in miles to search within that radius. Location Autocomplete resolves partial town names and postcode prefixes, and List Locations browses the UK location tree. Results include each listing's distance from the search location.

How do category-specific filters work?

Call Get Search Filters for a category to see the filters it supports, such as make, model, fuel type, transmission and mileage for cars, with every option and its live listing count. Pass the ones you want to Search Listings as comma-separated key:value pairs, for example filters=vehicle_make:bmw,vehicle_fuel_type:petrol. Price, seller type, urgent-only and with-photos filters have their own parameters.

What vehicle data is returned for cars?

Car listings carry the full vehicle specification: make, model, year, mileage, fuel type, transmission, body type, engine size and power, MPG, CO2 emissions, insurance group, 0–62 mph time, top speed, colour, seats, doors and previous keepers. When the seller shows them, you also get the registration number and the vehicle history check flags, such as not stolen, not written off and not scrapped.

What seller information is available?

Get Listing Detail returns the seller's name, private or trade type, verified-business status with its checks, rating, how long they have been posting, when they were last active, total listings and listings by category. Phone numbers are returned only in the masked form Gumtree shows to logged-out visitors. Get Seller Listings returns the seller's full live inventory.

How do sorting and pagination work?

Search Listings sorts by relevance (default), date, price_asc, price_desc or distance. Each page returns about 25–30 listings and you can request up to 50 pages with the page parameter. Every response includes total_results and total_pages, and Get Seller Listings paginates the same way.

Does the API cover Gumtree outside the UK?

No. The API covers gumtree.com, the United Kingdom site, so there is no market selector. Prices are in GBP, and dates are returned both as Unix timestamps (*_utc) and ISO 8601 strings (*_at).

How much does the Gumtree Scraper API cost?

Search Listings, Get Search Filters, Get Listing Detail and Get Seller Listings each cost 5 credits per successful request, and a search page returns about 25–30 listings. Search Autocomplete, Location Autocomplete, List Locations and List Categories cost 1 credit. Failed requests cost 0 credits.

Start Building With the Gumtree Scraper API

Use 1,000 free credits to search UK classifieds, track car and property prices, inspect listings and analyze sellers.

No credit card required · 1,000 free credits · Failed requests cost 0 credits