How to scrape Gumtree: settings that work today

Extraction recipe

Detail pages carry structured data (Product, BreadcrumbList). You can read those fields straight from the HTML, or select any other field with extract rules (CSS selectors). The recipe below is a set of Scrape API extract rules: we ran it through our API on two real Gumtree pages with the settings on this page and kept only the fields that came back on both. It is checked again every week, and hidden if it stops working.

Ad pages

Validated 2026-10-13

Field	Type	Example
`product.availability`	text	InStock
`product.condition`	text	UsedCondition
`product.currency`	text	GBP
`product.image`	URL	https://img.gumtree.com/ePR8PyKf84wPHx7_RYmEag/700096c647c44679b6_9...
`product.name`	text	Trek roscoe 8
`product.price`	number (as text)	250.00
`product.sku`	number (as text)	1803797679
`product.url`	URL	https://www.gumtree.com/p/mountain-bikes/trek-roscoe-8/1803797679

Examples from www.gumtree.com/p/mountain-bikes/trek-roscoe-8/1803797679 on 2026-10-13, shortened.

Sample output (real, trimmed)

{
    "product": {
        "availability": "InStock",
        "condition": "UsedCondition",
        "currency": "GBP",
        "image": "https://img.gumtree.com/ePR8PyKf84wPHx7_RYmEag/700096c647c44679b6_928077a6e7e4/86",
        "name": "Trek roscoe 8",
        "price": "250.00",
        "sku": "1803797679",
        "url": "https://www.gumtree.com/p/mountain-bikes/trek-roscoe-8/1803797679"
    }
}

extract_rules (1 rule)

{
    "product": {
        "type": "fn",
        "fn": "const T = ['Product', 'ProductGroup', 'IndividualProduct', 'Vehicle', 'Car']; const n = [...document.querySelectorAll('script[type=\"application/ld+json\"]')].flatMap(s => { try { return [].concat(JSON.parse(s.textContent)).flatMap(x => x['@graph'] || [x]); } catch (e) { return []; } }).find(x => x && [].concat(x['@type']).some(t => T.includes(t))); if (!n) return null; const g = p => p.split('|').map(q => q.split('.').reduce((v, k) => v == null ? v : (Array.isArray(v) ? v[0] : v)?.[k], n)).find(v => v != null && v !== ''); const all = v => Array.isArray(v) ? v.map(all).filter(x => x != null).join(', ') : (v && typeof v === 'object' ? (v.name ?? v['@id'] ?? null) : (typeof v === 'string' ? v.replace('https://schema.org/', '').replace('http://schema.org/', '') : v ?? null)); const one = v => all(Array.isArray(v) ? v[0] : v); return { availability: all(g('offers.availability')), condition: all(g('offers.itemCondition')), currency: all(g('offers.priceCurrency|offers.priceSpecification.priceCurrency')), image: one(g('image.url|image')), name: all(g('name')), price: all(g('offers.price|offers.lowPrice|offers.priceSpecification.price')), sku: one(g('sku|mpn|productID')), url: one(g('url|offers.url')) };"
    }
}

Code

Complete scripts: set the UJEEBU_API_KEY environment variable and run them as they are. Each one sends the settings on this page and the extraction recipe, prints the extracted JSON, and prints the credits the request cost (the Ujb-Credits response header) on stderr. A non-200 answer stops the script with the API's error message.

Ad pages

Runs the recipe on the two pages it was validated on, one after the other.

gumtree_detail_sdk.py pip install ujeebu-python==0.1.5

# Scrape Gumtree ad pages with the Ujeebu Scrape API.
# Settings and extract rules validated on real pages on 2026-10-13 (Ujeebu site guide).
# Uses the official SDK ujeebu-python 0.1.5: pip install ujeebu-python==0.1.5
# Run: UJEEBU_API_KEY=your_key python3 gumtree_detail_sdk.py

import json
import os
import sys
import time

import requests
from ujeebu_python import UjeebuClient

API_KEY = os.environ.get("UJEEBU_API_KEY")
URLS = [
    "https://www.gumtree.com/p/mountain-bikes/trek-roscoe-8/1803797679",
    "https://www.gumtree.com/p/mountain-bikes/mountain-bikes-for-sale-/1803775888",
]
SETTINGS = {
    "js": True,
    "proxy_type": "premium",
    "proxy_country": "GB",
}
EXTRACT_RULES = {
    "product": {
        "type": "fn",
        "fn": "const T = ['Product', 'ProductGroup', 'IndividualProduct', 'Vehicle', 'Car']; const n = [...document.querySelectorAll('script[type=\"application/ld+json\"]')].flatMap(s => { try { return [].concat(JSON.parse(s.textContent)).flatMap(x => x['@graph'] || [x]); } catch (e) { return []; } }).find(x => x && [].concat(x['@type']).some(t => T.includes(t))); if (!n) return null; const g = p => p.split('|').map(q => q.split('.').reduce((v, k) => v == null ? v : (Array.isArray(v) ? v[0] : v)?.[k], n)).find(v => v != null && v !== ''); const all = v => Array.isArray(v) ? v.map(all).filter(x => x != null).join(', ') : (v && typeof v === 'object' ? (v.name ?? v['@id'] ?? null) : (typeof v === 'string' ? v.replace('https://schema.org/', '').replace('http://schema.org/', '') : v ?? null)); const one = v => all(Array.isArray(v) ? v[0] : v); return { availability: all(g('offers.availability')), condition: all(g('offers.itemCondition')), currency: all(g('offers.priceCurrency|offers.priceSpecification.priceCurrency')), image: one(g('image.url|image')), name: all(g('name')), price: all(g('offers.price|offers.lowPrice|offers.priceSpecification.price')), sku: one(g('sku|mpn|productID')), url: one(g('url|offers.url')) };",
    },
}


def scrape(client, url):
    # with extract_rules, client.scrape sends a JSON POST and the API answers {"result": {...}}
    try:
        response = client.scrape(url, params={**SETTINGS, "extract_rules": EXTRACT_RULES})
    except requests.RequestException as error:
        sys.exit(f"Request failed for {url}: {error}")
    if response.status_code != 200:
        try:
            message = response.json().get("message", response.text)
        except ValueError:
            message = response.text
        sys.exit(f"HTTP {response.status_code} for {url}: {str(message)[:300]}")
    print(f"Ujb-Credits: {response.headers.get('Ujb-Credits')}", file=sys.stderr)
    return response.json()["result"]


if not API_KEY:
    sys.exit("Set the UJEEBU_API_KEY environment variable.")

client = UjeebuClient(api_key=API_KEY)

for i, url in enumerate(URLS):
    if i:
        time.sleep(2)  # be polite: one page at a time
    print(json.dumps(scrape(client, url), indent=2, ensure_ascii=False))

gumtree_detail_sdk.mjs npm install @ujeebu-org/ujeebu-sdk@0.1.2

// Scrape Gumtree ad pages with the Ujeebu Scrape API.
// Settings and extract rules validated on real pages on 2026-10-13 (Ujeebu site guide).
// Uses the official SDK @ujeebu-org/ujeebu-sdk 0.1.2: npm install @ujeebu-org/ujeebu-sdk@0.1.2
// Run: UJEEBU_API_KEY=your_key node gumtree_detail_sdk.mjs

import { UjeebuClient } from '@ujeebu-org/ujeebu-sdk';

const API_KEY = process.env.UJEEBU_API_KEY;
const URLS = [
  "https://www.gumtree.com/p/mountain-bikes/trek-roscoe-8/1803797679",
  "https://www.gumtree.com/p/mountain-bikes/mountain-bikes-for-sale-/1803775888",
];
const SETTINGS = {
  js: true,
  proxy_type: "premium",
  proxy_country: "GB",
};
const EXTRACT_RULES = {
  product: {
    type: "fn",
    fn: "const T = ['Product', 'ProductGroup', 'IndividualProduct', 'Vehicle', 'Car']; const n = [...document.querySelectorAll('script[type=\"application/ld+json\"]')].flatMap(s => { try { return [].concat(JSON.parse(s.textContent)).flatMap(x => x['@graph'] || [x]); } catch (e) { return []; } }).find(x => x && [].concat(x['@type']).some(t => T.includes(t))); if (!n) return null; const g = p => p.split('|').map(q => q.split('.').reduce((v, k) => v == null ? v : (Array.isArray(v) ? v[0] : v)?.[k], n)).find(v => v != null && v !== ''); const all = v => Array.isArray(v) ? v.map(all).filter(x => x != null).join(', ') : (v && typeof v === 'object' ? (v.name ?? v['@id'] ?? null) : (typeof v === 'string' ? v.replace('https://schema.org/', '').replace('http://schema.org/', '') : v ?? null)); const one = v => all(Array.isArray(v) ? v[0] : v); return { availability: all(g('offers.availability')), condition: all(g('offers.itemCondition')), currency: all(g('offers.priceCurrency|offers.priceSpecification.priceCurrency')), image: one(g('image.url|image')), name: all(g('name')), price: all(g('offers.price|offers.lowPrice|offers.priceSpecification.price')), sku: one(g('sku|mpn|productID')), url: one(g('url|offers.url')) };",
  },
};

async function scrape(client, url) {
  let res;
  try {
    // client.scrape POSTs JSON when extract_rules is set (scrapeWithRules would send it as a GET query, which the API ignores)
    res = await client.scrape(url, { ...SETTINGS, extract_rules: EXTRACT_RULES });
  } catch (err) {
    const status = err.response?.status ?? 'error';
    const message = err.response?.data?.message ?? err.message;
    console.error(`HTTP ${status} for ${url}: ${String(message).slice(0, 300)}`);
    process.exit(1);
  }
  console.error(`Ujb-Credits: ${res.headers['ujb-credits']}`);
  return res.data.result;
}

if (!API_KEY) {
  console.error('Set the UJEEBU_API_KEY environment variable.');
  process.exit(1);
}

const client = new UjeebuClient(API_KEY);
const pause = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

for (const [i, url] of URLS.entries()) {
  if (i) await pause(2000); // be polite: one page at a time
  console.log(JSON.stringify(await scrape(client, url), null, 2));
}

gumtree_detail.py pip install requests

# Scrape Gumtree ad pages with the Ujeebu Scrape API.
# Settings and extract rules validated on real pages on 2026-10-13 (Ujeebu site guide).
# Run: UJEEBU_API_KEY=your_key python3 gumtree_detail.py   (pip install requests)

import json
import os
import sys
import time

import requests

API_URL = "https://api.ujeebu.com/scrape"
API_KEY = os.environ.get("UJEEBU_API_KEY")
URLS = [
    "https://www.gumtree.com/p/mountain-bikes/trek-roscoe-8/1803797679",
    "https://www.gumtree.com/p/mountain-bikes/mountain-bikes-for-sale-/1803775888",
]
SETTINGS = {
    "js": True,
    "proxy_type": "premium",
    "proxy_country": "GB",
}
EXTRACT_RULES = {
    "product": {
        "type": "fn",
        "fn": "const T = ['Product', 'ProductGroup', 'IndividualProduct', 'Vehicle', 'Car']; const n = [...document.querySelectorAll('script[type=\"application/ld+json\"]')].flatMap(s => { try { return [].concat(JSON.parse(s.textContent)).flatMap(x => x['@graph'] || [x]); } catch (e) { return []; } }).find(x => x && [].concat(x['@type']).some(t => T.includes(t))); if (!n) return null; const g = p => p.split('|').map(q => q.split('.').reduce((v, k) => v == null ? v : (Array.isArray(v) ? v[0] : v)?.[k], n)).find(v => v != null && v !== ''); const all = v => Array.isArray(v) ? v.map(all).filter(x => x != null).join(', ') : (v && typeof v === 'object' ? (v.name ?? v['@id'] ?? null) : (typeof v === 'string' ? v.replace('https://schema.org/', '').replace('http://schema.org/', '') : v ?? null)); const one = v => all(Array.isArray(v) ? v[0] : v); return { availability: all(g('offers.availability')), condition: all(g('offers.itemCondition')), currency: all(g('offers.priceCurrency|offers.priceSpecification.priceCurrency')), image: one(g('image.url|image')), name: all(g('name')), price: all(g('offers.price|offers.lowPrice|offers.priceSpecification.price')), sku: one(g('sku|mpn|productID')), url: one(g('url|offers.url')) };",
    },
}


def scrape(url):
    response = requests.post(
        API_URL,
        headers={"ApiKey": API_KEY},
        json={"url": url, **SETTINGS, "extract_rules": EXTRACT_RULES},
        timeout=180,
    )
    if response.status_code != 200:
        try:
            message = response.json().get("message", response.text)
        except ValueError:
            message = response.text
        sys.exit(f"HTTP {response.status_code} for {url}: {str(message)[:300]}")
    print(f"Ujb-Credits: {response.headers.get('Ujb-Credits')}", file=sys.stderr)
    return response.json()["result"]


if not API_KEY:
    sys.exit("Set the UJEEBU_API_KEY environment variable.")

for i, url in enumerate(URLS):
    if i:
        time.sleep(2)  # be polite: one page at a time
    print(json.dumps(scrape(url), indent=2, ensure_ascii=False))

gumtree_detail.mjs

// Scrape Gumtree ad pages with the Ujeebu Scrape API.
// Settings and extract rules validated on real pages on 2026-10-13 (Ujeebu site guide).
// Run: UJEEBU_API_KEY=your_key node gumtree_detail.mjs   (Node.js 18 or later)

const API_URL = 'https://api.ujeebu.com/scrape';
const API_KEY = process.env.UJEEBU_API_KEY;
const URLS = [
  "https://www.gumtree.com/p/mountain-bikes/trek-roscoe-8/1803797679",
  "https://www.gumtree.com/p/mountain-bikes/mountain-bikes-for-sale-/1803775888",
];
const SETTINGS = {
  js: true,
  proxy_type: "premium",
  proxy_country: "GB",
};
const EXTRACT_RULES = {
  product: {
    type: "fn",
    fn: "const T = ['Product', 'ProductGroup', 'IndividualProduct', 'Vehicle', 'Car']; const n = [...document.querySelectorAll('script[type=\"application/ld+json\"]')].flatMap(s => { try { return [].concat(JSON.parse(s.textContent)).flatMap(x => x['@graph'] || [x]); } catch (e) { return []; } }).find(x => x && [].concat(x['@type']).some(t => T.includes(t))); if (!n) return null; const g = p => p.split('|').map(q => q.split('.').reduce((v, k) => v == null ? v : (Array.isArray(v) ? v[0] : v)?.[k], n)).find(v => v != null && v !== ''); const all = v => Array.isArray(v) ? v.map(all).filter(x => x != null).join(', ') : (v && typeof v === 'object' ? (v.name ?? v['@id'] ?? null) : (typeof v === 'string' ? v.replace('https://schema.org/', '').replace('http://schema.org/', '') : v ?? null)); const one = v => all(Array.isArray(v) ? v[0] : v); return { availability: all(g('offers.availability')), condition: all(g('offers.itemCondition')), currency: all(g('offers.priceCurrency|offers.priceSpecification.priceCurrency')), image: one(g('image.url|image')), name: all(g('name')), price: all(g('offers.price|offers.lowPrice|offers.priceSpecification.price')), sku: one(g('sku|mpn|productID')), url: one(g('url|offers.url')) };",
  },
};

async function scrape(url) {
  const res = await fetch(API_URL, {
    method: 'POST',
    headers: { ApiKey: API_KEY, 'Content-Type': 'application/json' },
    body: JSON.stringify({ url, ...SETTINGS, extract_rules: EXTRACT_RULES }),
    signal: AbortSignal.timeout(180000),
  });
  const text = await res.text();
  if (res.status !== 200) {
    let message = text;
    try {
      message = JSON.parse(text).message ?? text;
    } catch {}
    console.error(`HTTP ${res.status} for ${url}: ${String(message).slice(0, 300)}`);
    process.exit(1);
  }
  console.error(`Ujb-Credits: ${res.headers.get('ujb-credits')}`);
  return JSON.parse(text).result;
}

if (!API_KEY) {
  console.error('Set the UJEEBU_API_KEY environment variable.');
  process.exit(1);
}

const pause = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

for (const [i, url] of URLS.entries()) {
  if (i) await pause(2000); // be polite: one page at a time
  console.log(JSON.stringify(await scrape(url), null, 2));
}

gumtree_detail.sh

#!/usr/bin/env bash
# Scrape Gumtree ad pages with the Ujeebu Scrape API.
# Settings and extract rules validated on real pages on 2026-10-13 (Ujeebu site guide).
# Run: UJEEBU_API_KEY=your_key bash gumtree_detail.sh   (curl 7.76 or later)
set -euo pipefail

curl -sS --fail-with-body --max-time 180 -D headers.txt \
  -X POST 'https://api.ujeebu.com/scrape' \
  -H "ApiKey: ${UJEEBU_API_KEY:?Set the UJEEBU_API_KEY environment variable.}" \
  -H 'Content-Type: application/json' \
  --data-binary @- <<'JSON'
{
  "url": "https://www.gumtree.com/p/mountain-bikes/trek-roscoe-8/1803797679",
  "js": true,
  "proxy_type": "premium",
  "proxy_country": "GB",
  "extract_rules": {
    "product": {
      "type": "fn",
      "fn": "const T = ['Product', 'ProductGroup', 'IndividualProduct', 'Vehicle', 'Car']; const n = [...document.querySelectorAll('script[type=\"application/ld+json\"]')].flatMap(s => { try { return [].concat(JSON.parse(s.textContent)).flatMap(x => x['@graph'] || [x]); } catch (e) { return []; } }).find(x => x && [].concat(x['@type']).some(t => T.includes(t))); if (!n) return null; const g = p => p.split('|').map(q => q.split('.').reduce((v, k) => v == null ? v : (Array.isArray(v) ? v[0] : v)?.[k], n)).find(v => v != null && v !== ''); const all = v => Array.isArray(v) ? v.map(all).filter(x => x != null).join(', ') : (v && typeof v === 'object' ? (v.name ?? v['@id'] ?? null) : (typeof v === 'string' ? v.replace('https://schema.org/', '').replace('http://schema.org/', '') : v ?? null)); const one = v => all(Array.isArray(v) ? v[0] : v); return { availability: all(g('offers.availability')), condition: all(g('offers.itemCondition')), currency: all(g('offers.priceCurrency|offers.priceSpecification.priceCurrency')), image: one(g('image.url|image')), name: all(g('name')), price: all(g('offers.price|offers.lowPrice|offers.priceSpecification.price')), sku: one(g('sku|mpn|productID')), url: one(g('url|offers.url')) };"
    }
  }
}
JSON
echo
grep -i '^ujb-credits' headers.txt >&2

gumtree_detail.php

<?php
// Scrape Gumtree ad pages with the Ujeebu Scrape API.
// Settings and extract rules validated on real pages on 2026-10-13 (Ujeebu site guide).
// Run: UJEEBU_API_KEY=your_key php gumtree_detail.php   (PHP 7.4 or later with curl)

$apiKey = getenv('UJEEBU_API_KEY') ?: exit("Set the UJEEBU_API_KEY environment variable.\n");
$urls = [
    'https://www.gumtree.com/p/mountain-bikes/trek-roscoe-8/1803797679',
    'https://www.gumtree.com/p/mountain-bikes/mountain-bikes-for-sale-/1803775888',
];
$settings = [
    'js' => true,
    'proxy_type' => 'premium',
    'proxy_country' => 'GB',
];
$extractRules = [
    'product' => [
        'type' => 'fn',
        'fn' => 'const T = [\'Product\', \'ProductGroup\', \'IndividualProduct\', \'Vehicle\', \'Car\']; const n = [...document.querySelectorAll(\'script[type="application/ld+json"]\')].flatMap(s => { try { return [].concat(JSON.parse(s.textContent)).flatMap(x => x[\'@graph\'] || [x]); } catch (e) { return []; } }).find(x => x && [].concat(x[\'@type\']).some(t => T.includes(t))); if (!n) return null; const g = p => p.split(\'|\').map(q => q.split(\'.\').reduce((v, k) => v == null ? v : (Array.isArray(v) ? v[0] : v)?.[k], n)).find(v => v != null && v !== \'\'); const all = v => Array.isArray(v) ? v.map(all).filter(x => x != null).join(\', \') : (v && typeof v === \'object\' ? (v.name ?? v[\'@id\'] ?? null) : (typeof v === \'string\' ? v.replace(\'https://schema.org/\', \'\').replace(\'http://schema.org/\', \'\') : v ?? null)); const one = v => all(Array.isArray(v) ? v[0] : v); return { availability: all(g(\'offers.availability\')), condition: all(g(\'offers.itemCondition\')), currency: all(g(\'offers.priceCurrency|offers.priceSpecification.priceCurrency\')), image: one(g(\'image.url|image\')), name: all(g(\'name\')), price: all(g(\'offers.price|offers.lowPrice|offers.priceSpecification.price\')), sku: one(g(\'sku|mpn|productID\')), url: one(g(\'url|offers.url\')) };',
    ],
];

function scrape(string $url, string $apiKey, array $settings, array $extractRules)
{
    $ch = curl_init('https://api.ujeebu.com/scrape');
    $headers = [];
    curl_setopt_array($ch, [
        CURLOPT_POST => true,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT => 180,
        CURLOPT_HTTPHEADER => ['ApiKey: ' . $apiKey, 'Content-Type: application/json'],
        CURLOPT_POSTFIELDS => json_encode(['url' => $url] + $settings + ['extract_rules' => $extractRules]),
        CURLOPT_HEADERFUNCTION => function ($ch, $line) use (&$headers) {
            if (strpos($line, ':') !== false) {
                [$k, $v] = explode(':', $line, 2);
                $headers[strtolower(trim($k))] = trim($v);
            }
            return strlen($line);
        },
    ]);
    $body = curl_exec($ch);
    if ($body === false) {
        fwrite(STDERR, 'Request failed: ' . curl_error($ch) . "\n");
        exit(1);
    }
    $status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
    if ($status !== 200) {
        $message = json_decode($body, true)['message'] ?? $body;
        fwrite(STDERR, "HTTP $status for $url: " . substr((string) $message, 0, 300) . "\n");
        exit(1);
    }
    fwrite(STDERR, 'Ujb-Credits: ' . ($headers['ujb-credits'] ?? '?') . "\n");
    return json_decode($body, true)['result'];
}

foreach ($urls as $i => $url) {
    if ($i > 0) {
        sleep(2); // be polite: one page at a time
    }
    echo json_encode(scrape($url, $apiKey, $settings, $extractRules), JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE), "\n";
}

gumtree_detail.go go mod init scraper && go get github.com/ujeebu/ujeebu-go@v0.1.8

// Scrape Gumtree ad pages with the Ujeebu Scrape API.
// Settings and extract rules validated on real pages on 2026-10-13 (Ujeebu site guide).
// Uses the official SDK github.com/ujeebu/ujeebu-go v0.1.8: go mod init scraper && go get github.com/ujeebu/ujeebu-go@v0.1.8
// Run: UJEEBU_API_KEY=your_key go run gumtree_detail.go

package main

import (
	"encoding/json"
	"errors"
	"fmt"
	"os"
	"time"

	ujeebu "github.com/ujeebu/ujeebu-go"
)

var urls = []string{
	"https://www.gumtree.com/p/mountain-bikes/trek-roscoe-8/1803797679",
	"https://www.gumtree.com/p/mountain-bikes/mountain-bikes-for-sale-/1803775888",
}

// The extract rules of the recipe, as the JSON the API takes.
const extractRulesJSON = `{
    "product": {
        "type": "fn",
        "fn": "const T = ['Product', 'ProductGroup', 'IndividualProduct', 'Vehicle', 'Car']; const n = [...document.querySelectorAll('script[type=\"application/ld+json\"]')].flatMap(s => { try { return [].concat(JSON.parse(s.textContent)).flatMap(x => x['@graph'] || [x]); } catch (e) { return []; } }).find(x => x && [].concat(x['@type']).some(t => T.includes(t))); if (!n) return null; const g = p => p.split('|').map(q => q.split('.').reduce((v, k) => v == null ? v : (Array.isArray(v) ? v[0] : v)?.[k], n)).find(v => v != null && v !== ''); const all = v => Array.isArray(v) ? v.map(all).filter(x => x != null).join(', ') : (v && typeof v === 'object' ? (v.name ?? v['@id'] ?? null) : (typeof v === 'string' ? v.replace('https://schema.org/', '').replace('http://schema.org/', '') : v ?? null)); const one = v => all(Array.isArray(v) ? v[0] : v); return { availability: all(g('offers.availability')), condition: all(g('offers.itemCondition')), currency: all(g('offers.priceCurrency|offers.priceSpecification.priceCurrency')), image: one(g('image.url|image')), name: all(g('name')), price: all(g('offers.price|offers.lowPrice|offers.priceSpecification.price')), sku: one(g('sku|mpn|productID')), url: one(g('url|offers.url')) };"
    }
}`

var extractRules map[string]any

func fail(format string, args ...any) {
	fmt.Fprintf(os.Stderr, format+"\n", args...)
	os.Exit(1)
}

func short(s string) string {
	if len(s) > 300 {
		return s[:300]
	}
	return s
}

func params(target string) ujeebu.ScrapeParams {
	p := ujeebu.ScrapeParams{URL: target}
	p.JS = true
	p.ProxyType = "premium"
	p.ProxyCountry = "GB"
	p.ExtractRules = extractRules
	return p
}

func scrape(client *ujeebu.Client, target string) map[string]any {
	// the int is the credits the request cost (the Ujb-Credits header), not an HTTP status
	resp, credits, err := client.Scrape(params(target))
	if err != nil {
		var apiErr *ujeebu.APIError
		if errors.As(err, &apiErr) {
			fail("HTTP %d for %s: %s", apiErr.StatusCode, target, short(apiErr.Message))
		}
		fail("Request failed for %s: %v", target, err)
	}
	fmt.Fprintf(os.Stderr, "Ujb-Credits: %d\n", credits)
	result, _ := resp.Result.(map[string]any)
	return result
}

func printJSON(v any) {
	enc := json.NewEncoder(os.Stdout)
	enc.SetEscapeHTML(false)
	enc.SetIndent("", "  ")
	if err := enc.Encode(v); err != nil {
		fail("Cannot print the result: %v", err)
	}
}

func main() {
	apiKey := os.Getenv("UJEEBU_API_KEY")
	if apiKey == "" {
		fail("Set the UJEEBU_API_KEY environment variable.")
	}
	if err := json.Unmarshal([]byte(extractRulesJSON), &extractRules); err != nil {
		fail("Bad extract rules: %v", err)
	}
	client, err := ujeebu.NewClient(apiKey, ujeebu.WithTimeout(180*time.Second))
	if err != nil {
		fail("%v", err)
	}

	for i, target := range urls {
		if i > 0 {
			time.Sleep(2 * time.Second) // be polite: one page at a time
		}
		printJSON(scrape(client, target))
	}
}

SDK tabs use the official Ujeebu SDKs (ujeebu-python 0.1.5, @ujeebu-org/ujeebu-sdk 0.1.2, github.com/ujeebu/ujeebu-go v0.1.8); there is no PHP SDK, so the PHP tab calls the API with curl. For agents and scripts, the same status and settings are at /scrape/gumtree.json.

Try it yourself

Run this on Gumtree with your own key

Get a free API key, set UJEEBU_API_KEY and run any script above as it is. 5,000 free credits for 7 days, no card. These settings use proxy_country, which is available on paid plans.

Get a free API key or try these settings in the Playground first →

URL patterns and pagination

What the URLs look like, read from the pages our checks fetched.

Ad pages

Pattern: https://www.gumtree.com/p/mountain-bikes/{slug}/{id}
Validated on: https://www.gumtree.com/p/mountain-bikes/trek-roscoe-8/1803797679https://www.gumtree.com/p/mountain-bikes/mountain-bikes-for-sale-/1803775888

Settings that work today

From our health checks over the last 7 days: the cheapest settings that return the real page most of the time.

Endpoint	`/scrape`
`js`	`true`
`proxy_type`	`premium`
`proxy_country`	`GB` (paid plans)
Cost	up to 25 credits a request (only HTTP 200 and 404 are billed)

These settings use proxy_country. Proxy country (geo-targeting) is available on paid plans, so they need a paid plan: the free trial does not include it.

For search and listing pages, change the query or the page parameter in the URL to paginate, and fetch the pages one after another rather than in bursts. Collect detail page URLs from listing pages first, then fetch each detail page. Our checks run with JavaScript rendering on (js=true): keep it on. Start with the premium proxy, the cheapest one that passed most of its attempts in our checks.

Try it in the Playground

Proxy	Attempts	Passed
Premium	18	10

The cheapest proxy that passes most of our checks of this site.

Troubleshooting

The failures our own checks of gumtree.com ran into over the last 7 days, and what got the page in the same check.

What happened	Times	What fixed it
The page did not load in time	7	Nothing we tried in the same check. Retry later, one request at a time.
Page not found	1	The page was gone (HTTP 404). Not billed as a failure of the site: drop the URL.

A failed request is not billed: only HTTP 200 and 404 responses cost credits.

What people build with Gumtree data

Price researchSee what similar items sell for, by condition and location.More on this use case
New ads alertsCatch new ads for the searches you care about shortly after they appear.

Limits and etiquette

Public pages only. Pages behind a login, and data shown only to signed-in users, are out of scope.
Keep the rate modest: fetch pages one after another or with low concurrency, and cache what you already have.
robots.txt of www.gumtree.com (read 2026-10-13): public pages asked to stay away (Disallow: /search); no crawl delay set.
Read Gumtree's terms of service before you collect data at scale, and do not collect personal data you have no basis to process. This guide is not legal advice.

Questions

Can you scrape Gumtree with Ujeebu?

Partly. 12 of 20 checks of public Gumtree pages passed in the last 7 days; most failures were the page did not load in time. Retry failed pages later, and use the settings on this page.

Which settings work for Gumtree?

Call /scrape with js=true, proxy_type=premium, proxy_country=GB. On the premium proxy, 10 of 18 attempts passed in the last 7 days.

How many credits does a Gumtree request cost?

With these settings a request costs up to 25 credits. Only responses with HTTP 200 or 404 are billed: a blocked or timed-out request is free.

Which fields can I extract from Gumtree?

With the extraction recipes on this page, validated on real Gumtree pages through our API: ad pages: availability, condition, currency, image, name, price, sku, url. Pass the recipe as extract_rules in a POST to /scrape and the API returns those fields as JSON.

Is it allowed to scrape Gumtree?

Its robots.txt asks generic crawlers to stay away from public pages (Disallow: /search). Collect public pages only, read Gumtree's terms of service, keep your request rate modest and do not collect personal data you have no basis to process. This is not legal advice.

How fresh is this page?

The status and settings come from our own health checks of gumtree.com, which run around the clock. Last check: 2026-10-13 19:04:27 UTC; last pass: 2026-10-13 19:04:27 UTC.

Related site guides

All site guides