> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Listing

> Full Gumtree listing from the UK, Australia or South Africa — description, every attribute (full vehicle spec for cars), images, location, seller profile and similar listings.

Fetch one Gumtree listing in full: the description, every category attribute,
all images, location and coordinates, the seller's profile and Gumtree's
similar listings. Motors listings carry the vehicle spec — in the UK make,
model, mileage, MPG, CO2, insurance group, previous keepers and the vehicle
history-check flags; in Australia make, model, variant, odometer, VIN and rego.
Property, jobs, pets and services listings carry their own attribute sets.

**Credits:** 5

## Authorization

**X-API-Key** `string` *required*

Your ScrapeBadger API key.

## Path Parameters

**listing\_id** `string` *required*

Gumtree listing id from the end of the listing URL, returned as `id` by
[`/search`](https://docs.scrapebadger.com/api-reference/endpoint/gumtree/search):

* `uk`: \~10 digits, e.g. `1803293391`.
* `au`: \~10 digits, e.g. `1344981847`.
* `za`: the listing ref at the end of a `gumtree.co.za/listing/<ref>` URL,
  e.g. `ls26bvmcpnsqmz7l9jz`.

## Query Parameters

**market** `string` (default: uk)

`uk` (gumtree.com), `au` (gumtree.com.au) or `za` (gumtree.co.za). Must match
the site the listing id comes from — a `za` ref with `uk` / `au`, or a
numeric id with `za`, is a `400`.

## Response

**market** `string`

`uk`, `au` or `za`.

**id** `string`

Listing id.

**title** `string`

**url** `string`

**description** `string`

Full description text.

**price** `number`

Numeric price in `currency`; `null` for negotiable or contact-for-price ads.

**price\_text** `string`

Price as shown, e.g. `£5,699.00`, `$16,990`, `R190,000`.

**price\_frequency** `string`

`pm` / `pw` for rentals.

**price\_type** `string`

`au`: `FIXED`, `NEGOTIABLE`, `CONTACT_ME`, `FREE`, `SWAP_TRADE` … `za`: `ASKING_PRICE`, `POA` …

**currency** `string`

`GBP`, `AUD` or `ZAR`.

**vat** `string`

Motors trade listings: `Inc VAT` / `No VAT`.

**location** `string`

e.g. `Larkhall, South Lanarkshire`.

**area** `string`

**sub\_area** `string`

**location\_id** `string`

**postcode** `string`

**latitude** `number`

**longitude** `number`

**category\_id** `integer | string`

Integer on `uk` / `au`, ref string on `za` (e.g. `p6dnh`).

**category\_name** `string`

**category\_ids** `(integer | string)[]`

Root-to-leaf category ids (refs on `za`).

**breadcrumbs** `Breadcrumb[]`

`name`, `url`.

**image\_urls** `string[]`

**video\_urls** `string[]`

**posted\_text** `string`

Relative age as shown, e.g. `1 day ago`.

**posted\_utc** `number`

Last (re)posted, Unix seconds — moves when the ad is bumped.

**posted\_at** `string`

Same, ISO 8601 UTC.

**created\_utc** `number`

When the ad was first created, Unix seconds.

**created\_at** `string`

Same, ISO 8601 UTC.

**updated\_utc** `number`

**updated\_at** `string`

**expires\_at** `string`

Date the ad is valid through (`YYYY-MM-DD`).

**status** `string`

`au`: e.g. `ACTIVE`. `za`: e.g. `PUBLISHED`.

**view\_count** `integer`

`au` / `za`: views of this ad.

**reply\_count** `integer`

`au`: replies to this ad.

**is\_featured** `boolean`

**is\_urgent** `boolean`

**is\_bumped\_up** `boolean`

**is\_standout** `boolean`

**favourite\_count** `integer`

**vehicle\_history\_checked** `boolean`

Motors: Gumtree's vehicle history check ran on this car.

**attributes** `Attribute[]`

Every category attribute — `key`, `label`, `value`, `unit`, e.g.
`{"key": "vehicle_mileage", "label": "Mileage", "value": "94130", "unit": "miles"}`.

**seller** `Seller`

The seller's profile.

**Seller**

**name** `string`

**user\_id** `string`

**public\_id** `string`

**type** `string`

`Private`, `Trade` or `Agency`.

**is\_pro** `boolean`

**posting\_since** `string`

e.g. `6+ years`.

**member\_since\_year** `integer`

`au` / `za`: year the account opened.

**last\_active\_text** `string`

`au`: e.g. `yesterday`.

**last\_active\_utc** `number`

**last\_active\_at** `string`

**total\_listings** `integer`

Live listings right now.

**lifetime\_listings** `integer`

Ads ever posted. No market publishes it at present (`null`).

**total\_views** `integer`

Views across all their ads. No market publishes it at present (`null`).

**listings\_last\_year** `integer`

**listings\_by\_category** `object`

Category name → live listing count.

**reply\_speed** `string`

**reply\_rate** `string`

**rating** `object`

`average`, `total`, and a per-star `breakdown`.

**verification** `object`

`status`, `label` (e.g. `Business Verified`) and the `checks` Gumtree ran (`za`: e.g. `identity`, `mobileNumber`).

**phone\_masked** `string`

The masked phone number shown on the listing page, e.g. `0794997XXXX` (`uk`); always `null` on `au` and `za`. Full numbers are never returned.

**website\_url** `string`

**avatar\_url** `string`

**logo\_url** `string`

**badges** `string[]`

**seller\_skills** `string[]`

Services listings only.

**seller\_listings\_url** `string`

The seller's other ads on the Gumtree site.

**similar\_listings** `ListingSummary[]`

Gumtree's similar listings, in the same shape as
[`/search`](https://docs.scrapebadger.com/api-reference/endpoint/gumtree/search#response) listings.

## Example

```bash cURL theme={null}
curl "https://scrapebadger.com/v1/gumtree/listings/1803293391" \
  -H "X-API-Key: YOUR_API_KEY"
```

```javascript Node.js theme={null}
const res = await fetch("https://scrapebadger.com/v1/gumtree/listings/1803293391", {
  headers: { "X-API-Key": process.env.SCRAPEBADGER_API_KEY },
});
const listing = await res.json();
```

```python Python theme={null}
import requests

res = requests.get(
    "https://scrapebadger.com/v1/gumtree/listings/1803293391",
    headers={"X-API-Key": "YOUR_API_KEY"},
)
listing = res.json()
```

```json Response theme={null}
{
  "market": "uk",
  "id": "1803293391",
  "title": "Mazda, 2, Hatchback, 2018, Manual, 1496 (cc), 5 doors",
  "description": "Welcome to Thomson Twins Motors. We are based in Larkhall, Scotland. Our cars come with a Fresh Service, Valeted inside and long MOT's...",
  "price": 5699.0,
  "price_text": "£5,699.00",
  "price_frequency": null,
  "currency": "GBP",
  "vat": "No VAT",
  "location": "Larkhall, South Lanarkshire",
  "area": "South Lanarkshire",
  "sub_area": "Larkhall",
  "location_id": "11000569",
  "postcode": "ML93BQ",
  "latitude": 55.7269,
  "longitude": -3.92624,
  "category_id": 10312,
  "category_name": "Mazda",
  "category_ids": [2551, 9311, 10312],
  "breadcrumbs": [
    { "name": "Home", "url": "https://www.gumtree.com/" },
    { "name": "Motors", "url": "https://www.gumtree.com/cars-vans-motorbikes/uk/larkhall" },
    { "name": "Cars", "url": "https://www.gumtree.com/cars-vans-motorbikes/cars/uk/larkhall" },
    { "name": "Mazda", "url": "https://www.gumtree.com/cars-vans-motorbikes/cars/mazda/uk/larkhall" }
  ],
  "image_urls": [
    "https://img.gumtree.com/ePR8PyKf84wPHx7_RYmEag/cba6556cbcb7464a97_78d604ec62db/86",
    "https://img.gumtree.com/ePR8PyKf84wPHx7_RYmEag/b5a807b290974290b8_5c9645400e3e/86"
  ],
  "video_urls": [],
  "posted_text": "1 day ago",
  "posted_utc": 1791643486.952,
  "posted_at": "2026-10-10T14:44:46.952000Z",
  "created_utc": 1790675543.83,
  "created_at": "2026-09-29T09:52:23.830000Z",
  "updated_utc": 1791643487.028,
  "updated_at": "2026-10-10T14:44:47.028000Z",
  "expires_at": "2026-11-09",
  "is_featured": false,
  "is_urgent": false,
  "is_bumped_up": false,
  "is_standout": false,
  "favourite_count": 2,
  "vehicle_history_checked": true,
  "attributes": [
    { "key": "vehicle_make", "label": "Make", "value": "Mazda", "unit": null },
    { "key": "vehicle_model", "label": "Model", "value": "2", "unit": null },
    { "key": "vehicle_registration_year", "label": "Year", "value": "2018", "unit": null },
    { "key": "vehicle_mileage", "label": "Mileage", "value": "94130", "unit": "miles" },
    { "key": "vehicle_transmission", "label": "Transmission", "value": "Manual", "unit": null },
    { "key": "vehicle_fuel_type", "label": "Fuel type", "value": "Petrol", "unit": null },
    { "key": "vehicle_average_mpg", "label": "Fuel Consumption", "value": "62.8", "unit": "mpg" }
  ],
  "seller": {
    "name": "Thomson Twins Motors Ltd",
    "user_id": "91457907",
    "public_id": "41d401e0ec9e0dfa128b17775c8f2f9d",
    "type": "Trade",
    "is_pro": true,
    "posting_since": "4+ months",
    "rating": {
      "average": 0.0,
      "total": 0,
      "breakdown": { "1": 0, "2": 0, "3": 0, "4": 0, "5": 0 }
    },
    "verification": {
      "status": "VERIFIED",
      "label": "Business Verified",
      "checks": ["Age verification (maximum)", "Age verification (minimum)", "Directors"]
    },
    "phone_masked": null,
    "badges": []
  },
  "seller_skills": [],
  "seller_listings_url": "https://www.gumtree.com/sellerads/1803293391?userId=91457907&publicUserId=41d401e0ec9e0dfa128b17775c8f2f9d",
  "similar_listings": [
    {
      "id": "1803422383",
      "title": "2017 Mazda MX-5 1.5 SE-L Nav 2dr CONVERTIBLE PETROL Manual",
      "url": "https://www.gumtree.com/p/mazda/2017-mazda-mx-5-1.5-se-l-nav-2dr-convertible-petrol-manual/1803422383",
      "price": 12695.0,
      "price_text": "£12,695.00",
      "location": "Colchester, Essex",
      "postcode": "CO27QB",
      "seller_type": "Trade",
      "posted_text": "Just now"
    }
  ]
}
```

### South Africa

```bash theme={null}
curl "https://scrapebadger.com/v1/gumtree/listings/ls26bvmcpnsqmz7l9jz?market=za" \
  -H "X-API-Key: YOUR_API_KEY"
```

```json Response (abridged) theme={null}
{
  "market": "za",
  "id": "ls26bvmcpnsqmz7l9jz",
  "title": "Toyota Yaris",
  "url": "https://www.gumtree.co.za/listing/ls26bvmcpnsqmz7l9jz",
  "description": "2018 Toyota Yaris …",
  "price": 190000.0,
  "price_text": "R190,000",
  "price_type": "ASKING_PRICE",
  "currency": "ZAR",
  "location": "Weltevreden Park",
  "area": "Gauteng",
  "location_id": "mxm68",
  "category_id": "p6dnh",
  "category_name": "Cars & Bakkies",
  "category_ids": ["kyzkk", "l4dq6", "p6dnh"],
  "posted_at": "2026-10-13T17:34:24.365000Z",
  "expires_at": "2026-11-12",
  "status": "PUBLISHED",
  "view_count": 3,
  "attributes": [
    { "key": "sellerType", "label": "Seller Type", "value": "Owner", "unit": null },
    { "key": "make", "label": "Make", "value": "Toyota", "unit": null },
    { "key": "model", "label": "Model", "value": "Yaris", "unit": null },
    { "key": "year", "label": "Year", "value": "2018", "unit": null },
    { "key": "mileageKm", "label": "Kilometres", "value": "85000", "unit": null },
    { "key": "transmission", "label": "Transmission", "value": "Automatic", "unit": null }
  ],
  "seller": {
    "name": "Thanuj",
    "user_id": "s16zcgy0ntjnvg2",
    "public_id": "s16zcgy0ntjnvg2",
    "type": "Private",
    "member_since_year": 2016,
    "verification": {
      "status": null,
      "label": null,
      "checks": ["identity", "mobileNumber"]
    },
    "phone_masked": null
  }
}
```

### Australia

```bash theme={null}
curl "https://scrapebadger.com/v1/gumtree/listings/1344981847?market=au" \
  -H "X-API-Key: YOUR_API_KEY"
```

```json Response (abridged) theme={null}
{
  "market": "au",
  "id": "1344981847",
  "title": "2018 Holden Commodore RS ZB",
  "url": "https://www.gumtree.com.au/web/listing/cars-vans-utes/1344981847",
  "price": 16990.0,
  "price_text": "$16,990",
  "price_type": "FIXED",
  "currency": "AUD",
  "location": "25 Prindiville Drive Wangara WA 6065",
  "location_id": "3008658",
  "latitude": -31.79005,
  "longitude": 115.81883,
  "category_id": 18320,
  "posted_text": "11 minutes ago",
  "status": "ACTIVE",
  "view_count": 28,
  "reply_count": 0,
  "attributes": [
    { "key": "Make", "label": null, "value": "Holden", "unit": null },
    { "key": "Model", "label": null, "value": "Commodore", "unit": null },
    { "key": "Variant", "label": null, "value": "RS", "unit": null },
    { "key": "Year", "label": null, "value": "2018", "unit": null },
    { "key": "Odometer", "label": null, "value": "89168", "unit": null }
  ],
  "seller": {
    "name": "Wangara Motors",
    "user_id": "6242444948108",
    "type": "Trade",
    "is_pro": true,
    "member_since_year": 2015,
    "total_listings": 215,
    "phone_masked": null
  },
  "seller_listings_url": "https://www.gumtree.com.au/web/s-user/6242444948108"
}
```

> [!NOTE]
>
> **Phone numbers are masked.** `seller.phone_masked` is the masked form shown
> on the public listing page (e.g. `0794997XXXX` in the UK), or `null` when
> the seller shows none — always `null` in Australia and South Africa, where
> Gumtree puts phone numbers behind a login. The full number is never
> returned.

> [!TIP]
>
> Vehicle history-check flags arrive as attributes with the value `"true"` —
> `vehicle_not_stolen`, `vehicle_not_writeoff`, `vehicle_not_scrapped`,
> `vehicle_not_exported`, `vehicle_road_worthy` — alongside
> `vehicle_previous_keepers` and `vrn` (the registration) where the seller shows
> it.

## Errors

| Status | Meaning |
| - | - |
| `400` | The `listing_id` belongs to another market — a `za` ref with `uk` / `au`, or a numeric id with `za`. |
| `404` | Listing does not exist or has been removed. |
| `422` | `listing_id` is not 5–30 lowercase letters and digits, or Gumtree temporarily refused the request. **Not billed** — retry the latter shortly. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.