
TikTok Shop Scraper
scrape.ly/store/shelfbright/tiktok-shop-scraperE-commerceSocial media
1 monthly user

Scrape Gumtree classified ads from the UK, Australia and South Africa by search URL, ad URL or keyword. Get title, price, description, location, coordinates, seller type, posted date, views, photos and attributes such as make, model and mileage.
Scrape classified ads from Gumtree in the United Kingdom, Australia and South Africa: cars, furniture, bikes, electronics, property, jobs, pets and everything else people sell. Paste a search URL with your filters, a single ad URL, or just type a keyword. Every ad comes with title, price, full description, location with coordinates, seller type, posted date, views, all photos and the category attributes (make, model, year, mileage, condition, ...). No login, no browser, no Gumtree account.
| Field | What it does |
|---|---|
searchQueries | Keywords, one search each (e.g. sofa, toyota hilux) |
country | Site for the keywords: UK, AU or ZA (default UK) |
startUrls | Gumtree search URLs with any filters, or ad URLs, from any of the three sites |
location | UK town, city or postcode; Australian state, capital city or location id; South African province, city or suburb |
category | UK category slug (cars, for-sale, bicycles); Australian category id (18320 for cars); South African category name or slug |
maxResults | Maximum ads per search term or URL (default 20) |
minPrice, maxPrice | Price range in the site's currency |
sellerType | any, private or trade |
sort | newest, relevance, price_low, price_high |
radius | Distance around the location (UK only) |
includeDetails | Open every ad for the full details (default on) |
{
"startUrls": [
{ "url": "https://www.gumtree.com/search?search_category=cars&search_location=manchester&min_price=1000&max_price=3000" },
{ "url": "https://www.gumtree.com.au/s-cars-vans-utes/perth/c18320l3008303" }
],
"searchQueries": ["sofa"],
"country": "ZA",
"location": "Cape Town",
"maxResults": 50,
"includeDetails": true
}
| Field | Description |
|---|---|
id, url, country | Gumtree ad ID, link and site (UK, AU, ZA) |
title, description | Ad title and full description |
price, priceText, currency, priceType | Numeric price, price as shown, currency (GBP, AUD, ZAR) and price type |
category, categoryId, categoryPath | Category name, id and parent categories |
location, region, postcode, latitude, longitude | Where the item is |
sellerType | private or trade |
sellerName, sellerId | Seller's public display name and id (private and trade) |
sellerProfileUrl, sellerAvatar, sellerMemberSince | Profile link (Australia), avatar (Australia, South Africa) and member since / posting-for label |
sellerRating, sellerRatingCount, sellerAdsPosted | Seller rating and activity where Gumtree shows them |
sellerHasPhone, sellerVerifications | Whether the seller offers a phone number, and their verification badges |
postedAt, postedAgo, expiresAt | Posted date (AU and ZA), relative age as shown (UK, AU) and expiry date |
views | View count (AU and ZA, with details) |
images, imageCount | Photo URLs in the largest size and how many there are |
attributes | Category details such as make, model, year, mileage, fuel, condition, colour |
isFeatured, isUrgent, deliveryOption | Promotion flags and delivery option (UK) |
input, detailsScraped, scrapedAt | Which search or URL found the ad, whether details were loaded, and when |
Example (sample data in the real shape):
{
"id": "1801234567",
"url": "https://www.gumtree.com/p/cars/2015-ford-focus-1-0-zetec-ecoboost-5dr/1801234567",
"country": "UK",
"title": "2015 Ford Focus 1.0 Zetec EcoBoost 5dr",
"price": 2750,
"priceText": "£2,750",
"currency": "GBP",
"priceType": "FIXED",
"description": "Full service history, new clutch last year, MOT until June. Two keys. Any inspection welcome.",
"category": "Cars",
"categoryId": "9311",
"categoryPath": ["Cars Vans Motorbikes", "Cars"],
"location": "Salford",
"region": "Manchester",
"postcode": null,
"latitude": 53.4875,
"longitude": -2.2901,
"sellerType": "private",
"sellerName": "Sam",
"sellerId": "0a1b2c3d4e5f60718293a4b5c6d7e8f9",
"sellerProfileUrl": null,
"sellerAvatar": null,
"sellerMemberSince": "Posting for 5+ years",
"sellerRating": 4.8,
"sellerRatingCount": 12,
"sellerAdsPosted": "4 Ads in a year",
"sellerHasPhone": null,
"sellerVerifications": {"email": true},
"postedAt": null,
"postedAgo": "3 days ago",
"expiresAt": null,
"views": null,
"images": ["https://img.gumtree.com/example/1/214", "https://img.gumtree.com/example/2/214"],
"imageCount": 2,
"attributes": { "Year": "2015", "Mileage": "68,000 miles", "Fuel type": "Petrol", "Transmission": "Manual" },
"isFeatured": false,
"isUrgent": false,
"deliveryOption": "COLLECTION_ONLY",
"input": "https://www.gumtree.com/search?search_category=cars&search_location=manchester",
"detailsScraped": true,
"scrapedAt": "2026-10-15T08:00:00.000Z"
}
You pay $1.00 per 1,000 ads ($0.001 per ad), with full details included. Platform usage (compute and proxy traffic) is billed separately and is small: the actor uses plain HTTP requests, no browser. Example: 1,000 ads with full details cost $1.00 plus a few cents of usage.
Is it legal to scrape Gumtree? The actor only reads public ads that anyone can see without logging in. It collects the seller details Gumtree shows publicly on each ad, but never reveals hidden phone numbers. You are responsible for how you use the data; check the laws that apply to you (for example GDPR in the UK) and Gumtree's terms.
Do I need a Gumtree account or a proxy? No account and no login. The default datacenter proxy works for all three sites; if a site starts refusing those connections, the run switches that site to residential connections by itself.
How many results can I get? Up to your limit per search, within what each Gumtree site lists for one search: about 1,400 ads on Gumtree UK, 10,000 on Gumtree Australia and 375 on Gumtree South Africa. Add more searches (split by location, category or price) to go further; the run tells you when a search hits the site's ceiling and how many ads match in total.
Why are some fields empty? Not every site shows every field: exact posted dates come from Australia and South Africa, the UK shows a relative age ("3 days ago"); view counts exist for Australia and South Africa; coordinates and full attributes need Include full ad details. Empty means the ad or site did not provide it.
Can I run it on a schedule or through the API? Yes. Schedule it in the console or start it through the API, and get the results as JSON, CSV, Excel or HTML.
Can I filter by seller type?
Yes, private or trade. On Gumtree South Africa the seller type is only known from the ad page, so the run opens ads to check it.
sellerHasPhone only says whether a number is offered.Every field below can be set in the run form, passed through the API, or saved as a task. Unset fields fall back to the defaults shown.
searchQueriesarrayOptionalSearch terms
Keywords to search for, e.g. 'sofa', 'mountain bike' or 'toyota hilux'. Each term is one search on the site picked in 'Country site'.
countryenumOptionaldefault "UK"Country site
Which Gumtree to search with the search terms. URLs always use the site they belong to.
startUrlsarrayOptionalGumtree URLs
Search result URLs with filters already set on the site (e.g. https://www.gumtree.com/search?search_category=cars&search_location=manchester, https://www.gumtree.com.au/s-cars-vans-utes/perth/c18320l3008303, https://www.gumtree.co.za/search?q=sofa) or single ad URLs. UK, Australian and South African URLs can be mixed.
locationstringOptionalLocation
Where to search with the search terms. UK: a town, city or postcode (e.g. 'London', 'M1'). Australia: a state (NSW, VIC, QLD, WA, SA, TAS, ACT, NT), a capital city or a Gumtree location id. South Africa: a province, city or suburb (e.g. 'Cape Town'). Leave empty for the whole country.
categorystringOptionalCategory
Optional category for the search terms. UK: the category slug from a Gumtree URL (e.g. 'cars', 'for-sale', 'bicycles', 'flats-houses'). Australia: the numeric category id (the number after 'c' in a search URL, e.g. 18320 for cars). South Africa: the category name or slug (e.g. 'Couches & Sofas', 'cars-bakkies').
maxResultsintegerOptionaldefault 20Max results per search
Maximum number of ads to save for each search term or search URL.
minPriceintegerOptionalMinimum price
Only ads priced at or above this amount (in the site's currency: GBP, AUD or ZAR).
maxPriceintegerOptionalMaximum price
Only ads priced at or below this amount (in the site's currency).
sellerTypeenumOptionaldefault "any"Seller type
Keep only private or only trade (dealer / business) ads.
sortenumOptionaldefault "newest"Sort by
Order of results for search terms. Search URLs keep the order set in the URL.
radiusenumOptionalRadius (UK only)
Distance around the location, Gumtree UK only.
includeDetailsbooleanOptionaldefault trueInclude full ad details
Open every ad for the full description, all photos, exact location (coordinates, suburb, postcode), attributes (make, model, mileage, condition, ...), view count and seller type. Turn off for faster, lighter runs with search-card data only.
proxyConfigurationobjectOptionaldefault {"useScrapelyProxy":true,"scrapelyProxyGroups":["DATACENTER…Proxy configuration
Proxy used to reach Gumtree. Datacenter works for all three sites; if a site keeps refusing datacenter exits, the run switches that site to residential exits by itself.
Every run writes its results to a dataset. Preview it in the dashboard, then export it or read it through the API.
| Field | Type | Description |
|---|---|---|
| title | any | Title |
| url | any | URL |
| price | any | Price |
| currency | any | Currency |
| priceText | any | Price text |
| location | any | Location |
| region | any | Region |
| category | any | Category |
| sellerType | any | Seller |
| sellerName | any | Seller |
| postedAt | any | Posted |
| postedAgo | any | Posted (ago) |
| views | any | Views |
| imageCount | any | Photos |
| images | any | Image URLs |
| country | any | Site |
| id | any | Ad ID |
| description | any | Description |
You pay for the events the actor reports, such as each result or page it produces. Platform usage is included in the event prices.
| Event | Charged when | Price |
|---|---|---|
| Ad | Charged once for each Gumtree ad saved to the dataset (full details included). | $0.001 |
Run this actor from your own code. Swap in your API token and the examples work as-is.
import { ScrapelyClient } from 'scrapely-client'
const client = new ScrapelyClient({ token: process.env.SCRAPELY_TOKEN })
// Start the actor and wait for the run to finish.
const run = await client.actor('shelfbright/gumtree-scraper').call({
"searchQueries": [
"sofa"
],
"country": "UK",
"maxResults": 20
})
// Read the dataset the run produced.
const { items } = await client.dataset(run.defaultDatasetId).listItems()
console.log(items)Tokens live in your account settings. Keep them server-side: a token carries the full permissions of your account.
Connect the Scrape.ly MCP server once and your agent can run this actor as a tool. Pick your tool:
Fetch scrape.ly/agents.md and run shelfbright/gumtree-scraperPaste into Claude Code, Codex, Cursor or any AI agent. It signs you in once in the browser.
{
"mcpServers": {
"scrapely": {
"url": "https://api.scrape.ly/mcp?tools=actors,runs,storage,docs&actors=shelfbright/gumtree-scraper"
}
}
}No key in the file: your client opens the browser to sign you in the first time it connects.
Inputs the developer prepared for common jobs. Open one to see its input, then copy it to your account to run it as-is or adjust it.
Gumtree UK listings from a search link with details.
Gumtree Australia listings with details.
UK listings between 50 and 500 GBP from private sellers.
Newest Gumtree South Africa listings for a keyword.
Scrape.ly gives you the infrastructure, the tooling, and the team to extract, process, and operationalize web data at any scale. Setup takes minutes. The advantage lasts forever.