# Gumtree AU Listings, Sellers & Reviews Scraper (`abotapi/gumtree-au-scraper`) Actor Scrape gumtree.com.au classifieds across every vertical: for-sale goods, motors, real estate, jobs and services. Get title, description, price, all photos, GPS coordinates, category attributes, and seller profile + aggregate rating. Search by category + location + keyword, or paste any Gumtree URL. - **URL**: https://apify.com/abotapi/gumtree-au-scraper.md - **Developed by:** [Abot API](https://apify.com/abotapi) (community) - **Categories:** E-commerce, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.10 / 1,000 listing results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Gumtree Australia Scraper Scrape classified listings and seller information from **gumtree.com.au** across every vertical — for-sale goods, motors, real estate, jobs and services — in one run. Search by category, location and keyword, or paste any Gumtree URL you have already refined in your browser. ### What you get For every listing: - **Identity & link** — `id`, `url`, `title`, `description` - **Price** — `price` (numeric AUD), `priceText`, `priceType`, `currency`, `minimumOfferPrice`, `previousPriceString`, plus flags `isFree`, `isNegotiable`, `isSwapTrade`, `isPriceDrop`, `isDriveAway` - **Category** — `categoryId`, `categoryName`, `vertical` (`motors` / `property` / `jobs` / `services` / `for-sale`) - **Location** — `location`, `locationArea`, `locationState` - **Media** — `images` (all photo URLs), `imageCount`, `hasVideo`, `videos` - **Attributes** — a flattened `attributes` object with the listing's category-specific fields (e.g. mileage, body type, transmission for cars; bedrooms/bathrooms for property; pay/type for jobs) - **Motoring extras** — `carVin`, `carRecordReportUrl` where present - **Seller** — `sellerName` plus a nested `seller` object (see below) - **Activity** — `age`, `numberOfViews`, `numberOfReplies`, `numberOfOffers`, plus prominence flags `isFeatured`, `isUrgent`, `isHighlighted`, `isPremium` #### Seller & ratings Each record carries a nested `seller` object: ```` "seller": { "name": "Coastline Motors", "type": "dealer", "rating": 4.6, "reviewCount": 38, "ratingBadges": \["ID\_VERIFIED"], "ratingDistribution": null, "reviews": null } ```` **About seller reviews.** Gumtree publishes an **aggregate** seller rating only — an overall score (`rating`), the number of ratings behind it (`reviewCount`), and any trust badges (`ratingBadges`). It does **not** expose the individual buyer reviews (author, review text, dates) or a star-by-star breakdown, so `reviews` and `ratingDistribution` are always `null`. Many private sellers have no rating yet, in which case `rating` is `null` and `reviewCount` is `0`. **Scope note.** A listing's exact geo (precise suburb, postcode, GPS coordinates) and its full long-form description live only behind Gumtree's bot-managed listing page and are not available from the public data layer, so they are out of scope for this scraper. Each record carries the locality and state Gumtree returns with the search results, plus the search description snippet. ### Input Two modes — pick one: **Search mode** — choose a **category** (All, Cars & Vehicles, Real Estate, Jobs, Services, Home & Garden, Electronics, Pets, and more), a **location** (any suburb, city, region or state name — e.g. `Sydney`, `Melbourne`, `NSW`), and an optional **keyword**. Refine with **min/max price**, **sort order** (best match, most recent, price, kilometres, year), **radius**, and **ad type** (offering / wanted). **URL mode** — paste one or more gumtree.com.au search or listing URLs. Every filter you applied on the site (including sub-categories not in the dropdown) is respected, and the scraper walks result pages forward from where the URL starts. Common options: **Max listings**, **Max result pages per search**, a custom **dataset name**, and optional **MCP connectors** to pipe results into Notion, Linear, Airtable or Apify. #### Example input ```json { "mode": "search", "category": "cars-vehicles", "location": "Sydney", "keywords": "toyota hilux", "sortBy": "price_asc", "minPrice": 10000, "maxPrice": 40000, "maxItems": 100, "maxPages": 5 } ```` ### Example output ```json { "id": "1300000000", "url": "https://www.gumtree.com.au/web/listing/cars-vans-utes/1300000000", "title": "2016 Toyota HiLux SR5 Dual Cab", "description": "One owner, full service history, tow bar and canopy included...", "price": 32990, "priceText": "$32,990", "priceType": "FIXED", "currency": "AUD", "vertical": "motors", "categoryName": "Cars, Vans & Utes", "location": "Parramatta", "locationState": "NSW", "images": [ "https://images.gumtree.com.au/image/private/t_$_35/move/aaaaaaaa-1111-2222-3333-444444444444" ], "imageCount": 8, "attributes": { "carmileageinkms": "98000 km", "carbodytype": "Ute", "cartransmission": "Auto" }, "carVin": "MMSAAAAAAAA000000", "sellerName": "Coastline Motors", "seller": { "name": "Coastline Motors", "type": "dealer", "rating": 4.6, "reviewCount": 38, "ratingBadges": ["ID_VERIFIED"], "ratingDistribution": null, "reviews": null }, "age": "2 hours ago", "scrapedAt": "2026-07-04T00:00:00+00:00" } ``` *(Values above are illustrative.)* ### Notes - Gumtree serves Australian visitors, so runs use **Apify Residential proxy with country = AU** by default for reliable access. - Pricing is pay-per-result — you are charged per listing returned in the dataset. - Please review Gumtree's Terms of Use and scrape responsibly. # Actor input Schema ## `mode` (type: `string`): Search mode = build the query from the category / location / keyword filters below. URL mode = paste any gumtree.com.au search or listing URL you already refined in a browser (best for complex filters and sub-categories). ## `urls` (type: `array`): gumtree.com.au search-result URLs or listing URLs. Tip: open gumtree.com.au, choose a category + location + filters, then paste the resulting URL here. In URL mode all the filter fields below are ignored. ## `category` (type: `string`): Top-level category to search. 'All categories' searches every vertical. Covers Gumtree's main verticals: motors (Cars & Vehicles), property (Real Estate), Jobs, Services, plus the for-sale goods categories. ## `location` (type: `string`): Suburb, city, region or state to search in (e.g. 'Sydney', 'Melbourne', 'Brisbane', 'NSW'). Leave empty to search all of Australia. Names are resolved against Gumtree's own location index. ## `keywords` (type: `string`): Free-text keyword to search for (e.g. 'toyota hilux', 'iphone 15'). Optional — leave empty to browse the whole category. ## `adType` (type: `string`): Restrict to offers (items for sale / for hire) or wanted ads. Leave unset for both. ## `sortBy` (type: `string`): How to order results. Mileage / year options apply to motor listings. ## `minPrice` (type: `integer`): Only return listings priced at or above this amount. ## `maxPrice` (type: `integer`): Only return listings priced at or below this amount. ## `radius` (type: `integer`): Expand the search around the chosen location by this many kilometres. Leave empty for the location's default radius. ## `maxItems` (type: `integer`): Maximum number of listings to return across the whole run. 0 = no limit (bounded by Max pages). ## `maxPages` (type: `integer`): How many result pages to walk forward per search (24 listings per page). ## `proxy` (type: `object`): Gumtree serves Australian visitors — Apify Residential proxy with country = AU is recommended for reliable access. IP rotation is handled automatically. ## `mcpConnectors` (type: `array`): Optionally send scraped results into apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector once under Apify → Settings → Integrations, then select it here. The connector receives a condensed, human-readable summary per item; the full record stays in the dataset. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com). ## `notionParentPageUrl` (type: `string`): URL (or id) of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors. ## `maxNotifyListings` (type: `integer`): Cap on items written to each connector per run. Does not affect the dataset. ## Actor input object example ```json { "mode": "search", "urls": [ "https://www.gumtree.com.au/s-cars-vans-utes/sydney/c18320l3003435" ], "category": "all", "location": "Sydney", "maxItems": 100, "maxPages": 5, "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "AU" }, "maxNotifyListings": 50 } ``` # Actor output Schema ## `listings` (type: `string`): Individual listing records with price, location, image URLs, category attributes, and seller info. ## `output` (type: `string`): Run summary with total listings and request count. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "urls": [ "https://www.gumtree.com.au/s-cars-vans-utes/sydney/c18320l3003435" ], "location": "Sydney", "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "AU" } }; // Run the Actor and wait for it to finish const run = await client.actor("abotapi/gumtree-au-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "urls": ["https://www.gumtree.com.au/s-cars-vans-utes/sydney/c18320l3003435"], "location": "Sydney", "proxy": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "AU", }, } # Run the Actor and wait for it to finish run = client.actor("abotapi/gumtree-au-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "urls": [ "https://www.gumtree.com.au/s-cars-vans-utes/sydney/c18320l3003435" ], "location": "Sydney", "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "AU" } }' | apify call abotapi/gumtree-au-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=abotapi/gumtree-au-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Gumtree AU Listings, Sellers & Reviews Scraper", "description": "Scrape gumtree.com.au classifieds across every vertical: for-sale goods, motors, real estate, jobs and services. Get title, description, price, all photos, GPS coordinates, category attributes, and seller profile + aggregate rating. Search by category + location + keyword, or paste any Gumtree URL.", "version": "0.1", "x-build-id": "TJeGXha79fagSWpIY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~gumtree-au-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-gumtree-au-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/abotapi~gumtree-au-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-gumtree-au-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/abotapi~gumtree-au-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-gumtree-au-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "mode": { "title": "1. Search mode", "enum": [ "search", "url" ], "type": "string", "description": "Search mode = build the query from the category / location / keyword filters below. URL mode = paste any gumtree.com.au search or listing URL you already refined in a browser (best for complex filters and sub-categories).", "default": "search" }, "urls": { "title": "Search or listing URLs (URL mode)", "type": "array", "description": "gumtree.com.au search-result URLs or listing URLs. Tip: open gumtree.com.au, choose a category + location + filters, then paste the resulting URL here. In URL mode all the filter fields below are ignored.", "items": { "type": "string" } }, "category": { "title": "Category / vertical", "enum": [ "all", "cars-vehicles", "real-estate", "jobs", "services", "home-garden", "electronics-computer", "pets", "baby-children", "clothing-jewellery", "sport-fitness", "antiques-art", "books-music-games", "boats-jetskis", "community", "miscellaneous-goods", "tickets" ], "type": "string", "description": "Top-level category to search. 'All categories' searches every vertical. Covers Gumtree's main verticals: motors (Cars & Vehicles), property (Real Estate), Jobs, Services, plus the for-sale goods categories.", "default": "all" }, "location": { "title": "Location", "type": "string", "description": "Suburb, city, region or state to search in (e.g. 'Sydney', 'Melbourne', 'Brisbane', 'NSW'). Leave empty to search all of Australia. Names are resolved against Gumtree's own location index." }, "keywords": { "title": "Keyword", "type": "string", "description": "Free-text keyword to search for (e.g. 'toyota hilux', 'iphone 15'). Optional — leave empty to browse the whole category." }, "adType": { "title": "Ad type", "enum": [ "offering", "wanted" ], "type": "string", "description": "Restrict to offers (items for sale / for hire) or wanted ads. Leave unset for both." }, "sortBy": { "title": "Sort order", "enum": [ "rank", "date", "price_asc", "price_desc", "mileage_asc", "mileage_desc", "year_asc", "year_desc" ], "type": "string", "description": "How to order results. Mileage / year options apply to motor listings." }, "minPrice": { "title": "Minimum price (AUD)", "minimum": 0, "type": "integer", "description": "Only return listings priced at or above this amount." }, "maxPrice": { "title": "Maximum price (AUD)", "minimum": 0, "type": "integer", "description": "Only return listings priced at or below this amount." }, "radius": { "title": "Search radius (km)", "minimum": 0, "type": "integer", "description": "Expand the search around the chosen location by this many kilometres. Leave empty for the location's default radius." }, "maxItems": { "title": "Max listings", "minimum": 0, "type": "integer", "description": "Maximum number of listings to return across the whole run. 0 = no limit (bounded by Max pages).", "default": 100 }, "maxPages": { "title": "Max result pages per search", "minimum": 1, "type": "integer", "description": "How many result pages to walk forward per search (24 listings per page).", "default": 5 }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Gumtree serves Australian visitors — Apify Residential proxy with country = AU is recommended for reliable access. IP rotation is handled automatically.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "AU" } }, "mcpConnectors": { "title": "Pipe results into your apps (optional)", "type": "array", "description": "Optionally send scraped results into apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector once under Apify → Settings → Integrations, then select it here. The connector receives a condensed, human-readable summary per item; the full record stays in the dataset. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com)." }, "notionParentPageUrl": { "title": "Notion parent page (Notion connector only)", "type": "string", "description": "URL (or id) of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors." }, "maxNotifyListings": { "title": "Max items to export per connector", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Cap on items written to each connector per run. Does not affect the dataset.", "default": 50 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```