What Gumtree data does the API return?

Each listing as a standard car record: make, model and generation from a shared catalog, year, mileage, price and currency, location, photos and equipment, plus inspections and history reports when Gumtree publishes them.

How do I select Gumtree in the API?

Call /domains once to read the site ID of Gumtree for your key, then pass it as domains[] to /search or /cars.

What if the same car is on several sites?

It is one car with several listings. Each listing keeps its own site, ID, price and link, so you see every place the car is offered.

How do I keep a copy in sync?

Use the /cars export: start without a cursor and follow next_url until it ends. Run it again to refresh your copy.

Ask for a free demo key and tell us which sites you need. It returns real data in the same JSON as the paid plans.

United KingdomMarketplace

Gumtree API

Gumtree car listings from the UK as JSON: price, mileage, year, fuel and photos.

Get a free demo key Read the docs

On gumtree.com

gumtree.com

In your code

{"vin": string"brand": { name }"model": { name }"year": number"listings": [{"external": {…}"price": {…}"odometer": {…}"is_auction": boolean"images": […]}]"inspections": […]"vehicle_history_reports": […]}

Field names from the real record; values are types, not data.

What is Gumtree?

01/ 06About

About Gumtree

Gumtree is a UK classifieds site with a busy cars section for private sellers and dealers. Listings show price, mileage, year, fuel and photos. MotorAPIs reads them as standard car records.

Country: United Kingdom
Type: Marketplace
API: api.motorapis.com
Website: gumtree.com

What data do I get?

02/ 06Fields

What you get from Gumtree

Every listing, in the shared car record. Fields are filled when Gumtree shows them.

Vehicle

VIN, when the site shows it
Make, model and generation from one shared catalog
Year, fuel, transmission, engine, power
Mileage in km

Listing

Site and listing ID, link to the ad
Price and currency
Seller type and location
Photo gallery
Equipment options

Reports

Inspections, when published
History reports, when published

One car, many sites

The same car on several sites is one car
Sold cars stay readable for about a month

How do I ask for it?

03/ 06Requests

Three requests to start

Site IDs differ per key: read them from /domains once, then filter by them.

01Find the site ID of Gumtree

GET https://api.motorapis.com/domains
  x-api-key: YOUR_API_KEY

02Search its cars

GET https://api.motorapis.com/search?domains[]={domain_id}&perPage=20
  x-api-key: YOUR_API_KEY

03Export everything and keep it in sync

GET https://api.motorapis.com/cars?domains[]={domain_id}&limit=500
  x-api-key: YOUR_API_KEY

Anything else to know?

04/ 06FAQ

Questions about the Gumtree API

What Gumtree data does the API return?: Each listing as a standard car record: make, model and generation from a shared catalog, year, mileage, price and currency, location, photos and equipment, plus inspections and history reports when Gumtree publishes them.
How do I select Gumtree in the API?: Call /domains once to read the site ID of Gumtree for your key, then pass it as domains[] to /search or /cars.
What if the same car is on several sites?: It is one car with several listings. Each listing keeps its own site, ID, price and link, so you see every place the car is offered.
How do I keep a copy in sync?: Use the /cars export: start without a cursor and follow next_url until it ends. Run it again to refresh your copy.
How can I try it?: Ask for a free demo key and tell us which sites you need. It returns real data in the same JSON as the paid plans.

What else is connected?

05/ 06Related

Related sources

All sources →

Ready to try it?

06/ 06Start

Get Gumtree data in your product

Tell us which sources you need. We reply in writing with a free demo key.

Get a free demo key

MotorAPIs is an independent data provider and is not affiliated with Gumtree. Names and trademarks belong to their owners.