# Hipages Scraper - Australian Tradie & Home Services Leads (`scrapesage/hipages-scraper`) Actor Scrape hipages tradies & home-service businesses by trade and suburb, or from profile URLs. Get name, phone & mobile, ABN, licence flag, star rating & reviews, services, headline and a lead score. Monitoring, no login, no key, no browser. - **URL**: https://apify.com/scrapesage/hipages-scraper.md - **Developed by:** [Scrape Sage](https://apify.com/scrapesage) (community) - **Categories:** Lead generation, Real estate, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $8.00 / 1,000 tradie / business scrapeds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 ## Hipages Scraper — Australian Tradie & Home Services Leads (Phones, ABN & Reviews) Extract **complete tradie & home-service business data from [hipages](https://hipages.com.au)** — Australia's #1 home-improvement marketplace. Get the fields lead lists actually need: **business name, phone & mobile, ABN (with verification link), trade licence flag, service area, star rating & review count, services offered, headline and a 0-100 lead score** — for plumbers, electricians, builders, painters, carpenters, landscapers and 100+ trades, in any Australian suburb. No login, no API key, no browser — fast JSON extraction straight from the page data. ### Why this hipages scraper? The biggest home-services directories (Angi, Thumbtack, HomeAdvisor) sit behind anti-bot walls, so most "contractor lead" tools fall back to scraping Google Maps and miss the trade-specific signals. This actor reads hipages' own page data and ships the **richest tradie record in the category**: | Data | Typical scrapers | This actor | |---|---|---| | Business name + profile URL | ✅ | ✅ | | Phone / mobile number | partial | ✅ | | **ABN + ABR verification link** | ❌ | ✅ | | **Trade licence flag** | ❌ | ✅ | | Star rating + review count | partial | ✅ | | **Times hired / total ratings** | ❌ | ✅ | | **Services offered (full list)** | ❌ | ✅ | | Headline, tagline & highlights | ❌ | ✅ | | Premium / verified status | ❌ | ✅ | | Customer reviews (rating + text) | ❌ | ✅ opt-in | | **Homeowner job requests (demand-side leads)** | ❌ | ✅ opt-in | | Lead score (0-100) per tradie | ❌ | ✅ | | Monitoring — only new tradies | ❌ | ✅ | ### Use cases - **Lead generation** — tradies are high-intent local buyers for job-management & invoicing software (ServiceM8, Tradify, AroFlo, simPRO), payments, marketing, tools, materials and insurance. Score them by reputation and reach (`reviewCount`, `licensed`, `abnValid`, `isPremium`) and contact them by `phone` / `mobile`. - **Sales territory building** — pull every plumber / electrician / builder in a metro with phone, ABN and service area for route planning and outreach. - **Market & competitive intelligence** — compare ratings, services and review volumes across trades and suburbs. - **Demand intelligence** — turn on `includeJobLeads` to capture recent **homeowner job requests** (what work people want done, where) — a unique demand-side signal for tradies and lead vendors. - **Monitoring** — schedule recurring runs to watch a trade + area for **newly listed** tradies with monitoring mode. - **Aggregators & directories** — feed apps and CRMs with structured, verified Australian tradie data. ### How to use 1. [Sign up for Apify](https://console.apify.com/sign-up) — the free plan is enough to try this actor. 2. Open the **Hipages Scraper**, choose trades and locations (or paste hipages URLs), and click **Start**. 3. Watch tradies stream into the dataset table. 4. **Export** as JSON, CSV, Excel, XML, or RSS — or pull results via the [Apify API](https://docs.apify.com/api/v2). ### Input ```json { "categories": ["plumbers", "electricians"], "locations": ["Sydney, NSW", "Melbourne, VIC"], "maxResults": 200, "includeBusinessDetails": true, "includeReviews": false, "includeJobLeads": false, "expandNearbySuburbs": false, "monitorMode": false } ```` - **categories** — trades such as `plumbers`, `electricians`, `carpenters`, `painters`, `builders`, `tilers`, `plasterers`, `bricklayers`, `concreting`, `fencing`, `landscaping`, `roofing`, `gardening`, `handyman`, `gas_fitters`, `cabinet_makers`, `air_conditioning`, `pest_control`, `cleaning`, `removalists`. Friendly words like `plumber`, `sparky`, `aircon`, `removals` are auto-mapped, and any valid hipages category slug also works. Each trade pairs with every location. - **locations** — Australian `Suburb, STATE` (`Sydney, NSW`, `Bondi, NSW`, `Brisbane, QLD`). A suburb is required (hipages has no state-only listing); a bare state (`NSW`) or capital city (`Perth`) resolves to that capital. States: NSW, VIC, QLD, WA, SA, TAS, ACT, NT. - **startUrls** — hipages listing URLs (`/find///`) or profile URLs (`/connect/`). - **maxResults / maxBusinessesPerSearch** — global and per-search caps. - **minRating / minReviews / withPhoneOnly / licensedOnly / validAbnOnly** — quality & trust filters. - **includeBusinessDetails** *(default true)* — open each profile for ABN, full rating, services and review texts. - **includeServices** *(default true)* — the list of services each tradie offers. - **includeReviews** *(default false)* — output review records (type `review`). - **includeJobLeads** *(default false)* — output homeowner job-request records (type `job`). - **expandNearbySuburbs** *(default false)* — follow nearby suburbs for broader coverage (hipages has no deep pagination). - **monitorMode** *(default false)* — emit only tradies not seen in previous runs. ### Output One record per tradie (`type: "business"`), plus optional `review` and `job` records: ```json { "type": "business", "source": "hipages", "businessId": "3112625", "slug": "hoppysplumbing", "name": "Hoppy's Plumbing", "profileUrl": "https://hipages.com.au/connect/hoppysplumbing", "categoryName": "Plumbers", "tradeType": "Plumber", "state": "nsw", "suburb": "sydney", "serviceArea": "Sydney", "phone": "0462630927", "mobile": "0462630927", "abn": "62675918859", "abnValid": true, "abnVerifyUrl": "https://www.abr.business.gov.au/ABN/View/62675918859", "licensed": true, "rating": 4.9, "totalRatings": 604, "totalHired": 895, "reviewCount": 653, "headline": "We offer a full line of services for all your plumbing, drain cleaning and gas-fitting needs.", "highlights": ["Commercial Services", "Top Quality Services", "Plumbing & Gas-Fitting"], "isPremium": true, "serviceCount": 32, "services": ["Plumbers", "Bathroom Resurfacing", "Backflow Services", "New Drain Plumbing"], "aggregateRating": { "ratingValue": 5, "ratingCount": 22, "bestRating": 5, "worstRating": 1 }, "featuredRecommendation": { "comment": "Fixed my toilet within 10 minutes. Very happy.", "author": "Wei", "jobPostcode": 2000 }, "leadScore": 92, "searchCategory": "plumbers", "searchLocation": "Sydney, NSW", "scrapedAt": "2026-06-15T12:00:00.000Z" } ``` Review rows carry `businessName`, `rating`, `text`, `author` and `profileUrl`. Job rows carry the homeowner's `description`, `suburb`, `postcode` and `state`. ### Automate & schedule Run this actor on autopilot and pull results into your own stack: - **[Apify API](https://docs.apify.com/api/v2)** — start runs, fetch datasets, manage schedules over REST. - **[apify-client for JavaScript](https://docs.apify.com/api/client/js/)** and **[Python](https://docs.apify.com/api/client/python/)** — official SDKs. - **[Schedules](https://docs.apify.com/platform/schedules)** — run it daily/weekly to track newly listed tradies in a trade + area; perfect for lead pipelines. - **[Webhooks](https://docs.apify.com/platform/integrations/webhooks)** — trigger downstream actions (CRM import, Slack alert, email sequence) the moment a run finishes. ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'MY_APIFY_TOKEN' }); const run = await client.actor('scrapesage/hipages-scraper').call({ categories: ['plumbers', 'electricians'], locations: ['Sydney, NSW'], maxResults: 200, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(`Got ${items.length} tradies`); ``` ### Monitoring mode Turn on **monitorMode** and the actor remembers every business id it has returned (in a named key-value store) and emits **only new tradies** on the next run. It pairs cleanly with [Schedules](https://docs.apify.com/platform/schedules) — the schedule triggers the run; monitoring decides what's new — so you can watch a trade + area for newly listed businesses without conflict or duplicates. ### Integrate with any app Connect the dataset to 5,000+ apps — no code required: - **[Make](https://docs.apify.com/platform/integrations/make)** — multi-step automation scenarios. - **[Zapier](https://docs.apify.com/platform/integrations/zapier)** — push new tradie leads straight into your CRM. - **[Slack](https://docs.apify.com/platform/integrations/slack)** — get notified when a monitored search finds new tradies. - **[Google Drive / Sheets](https://docs.apify.com/platform/integrations/drive)** — auto-export every run to a spreadsheet. - **[Airbyte](https://docs.apify.com/platform/integrations/airbyte)** — pipe results into your data warehouse. - **[GitHub](https://docs.apify.com/platform/integrations/github)** — trigger runs from commits or releases. ### Use with AI assistants (MCP) The output is clean, LLM-ready JSON. Call this actor from Claude, ChatGPT, or any agent framework through the **[Apify MCP server](https://docs.apify.com/platform/integrations/mcp)** — ask your assistant to "find the top-rated licensed plumbers in Sydney with their phone numbers" and let it run this scraper for you. ### More scrapers from scrapesage Build a complete **local-business lead-gen stack**: - **[Houzz Scraper](https://apify.com/scrapesage/houzz-scraper)** — home-improvement pros, contacts and reviews. - **[Bark Listing Scraper](https://apify.com/scrapesage/bark-listing-scraper)** — service-provider leads from Bark. - **[Fresha Scraper](https://apify.com/scrapesage/fresha-scraper)** — salon, spa & beauty business leads. - **[Booksy Scraper](https://apify.com/scrapesage/booksy-scraper)** — beauty & wellness provider leads. - **[Healthgrades Scraper](https://apify.com/scrapesage/healthgrades-scraper)** — doctors & healthcare providers with reviews. - **[FindLaw Scraper](https://apify.com/scrapesage/findlaw-scraper)** — lawyers, law firms and contact leads. - **[Insurance Agent Scraper](https://apify.com/scrapesage/insurance-agent-scraper)** — State Farm & Farmers agent leads. - **[TaxBuzz Scraper](https://apify.com/scrapesage/taxbuzz-scraper)** — CPA, accountant & tax preparer leads. ### Tips - **More tradies per city**: each trade + suburb page returns the ~15-20 top-ranked tradies. To go deeper, add more suburbs (`Parramatta, NSW`, `Bondi, NSW`, …) or turn on `expandNearbySuburbs` to follow adjacent suburbs automatically. - **Best phone coverage**: phone & mobile come straight from the listing data — you get them even without business details. - **ABN & services**: keep `includeBusinessDetails` on — the ABN number, service catalogue and review texts live on each tradie's profile page. - **Cost control**: filter with `minRating` / `withPhoneOnly` / `licensedOnly` and cap with `maxResults`. Details, reviews and job leads are all opt-in. ### FAQ **How do I scrape tradies for a specific suburb?** Put the suburb in `locations` as `Suburb, STATE` (`Bondi, NSW`, `Carlton, VIC`) and pick `categories`. Each trade pairs with each location. **Which trades are supported?** Plumbers, electricians, carpenters, painters, builders, tilers, plasterers, bricklayers, concreters, fencing, landscaping, roofing, gardening, handyman, gas fitters, cabinet makers, air conditioning, pest control, cleaning, removalists and any other hipages category — friendly words auto-map and raw slugs pass through. **Where do phone numbers come from?** Phone and mobile come from hipages' own public listing data. hipages keeps tradies on-platform, so there is usually no external website to crawl — the phone is the contact. **What is the ABN field?** The Australian Business Number — a verified business identifier. The actor includes the number and an [Australian Business Register](https://www.abr.business.gov.au) verification link, so you can confirm and enrich each lead. **Can I export to Google Sheets, CSV, or Excel?** Yes — one click in the dataset view, or automatically every run via the [Google Drive integration](https://docs.apify.com/platform/integrations/drive). **How do I get only new tradies over time?** Turn on `monitorMode` and create a [Schedule](https://docs.apify.com/platform/schedules); each run emits only tradies not seen before. **A field is null — why?** Some tradies genuinely don't publish a particular detail (e.g. an ABN number, a service list, or a landline). Fields are `null` only when the data doesn't exist, not because the scraper skipped them. **Is scraping hipages legal?** This actor collects publicly available data only. You are responsible for using the data in compliance with applicable laws (including the Australian Privacy Act / GDPR / CCPA for personal data) and hipages' terms. ### Need help? Open an issue on the actor's **Issues** tab, or visit the [Apify help center](https://help.apify.com/). Feature requests are welcome — this actor is actively maintained. # Actor input Schema ## `categories` (type: `array`): Trade categories to search: e.g. plumbers, electricians, carpenters, painters, builders, tilers, plasterers, bricklayers, concreting, fencing, landscaping, roofing, gardening, handyman, gas\_fitters, cabinet\_makers, air\_conditioning, pest\_control, cleaning, removalists. Friendly words (plumber, sparky, aircon, removals) auto-map; any valid hipages category slug also works. Each category is combined with every location. ## `locations` (type: `array`): Australian suburb + state, e.g. `Sydney, NSW`, `Bondi, NSW`, `Melbourne, VIC`, `Brisbane, QLD`. A suburb is required (hipages has no state-only listing). A bare state (`NSW`) or a bare capital city (`Perth`) is accepted and resolves to that capital. States: NSW, VIC, QLD, WA, SA, TAS, ACT, NT. ## `startUrls` (type: `array`): Paste hipages listing URLs (`https://hipages.com.au/find///`) or tradie profile URLs (`https://hipages.com.au/connect/`). Processed in addition to the categories + locations above. ## `maxResults` (type: `integer`): Global cap on the number of business records emitted in this run, across all searches and Start URLs. ## `maxBusinessesPerSearch` (type: `integer`): Cap the number of tradies collected per trade + suburb page. Each hipages suburb page lists roughly 15-20 top-ranked tradies. ## `minRating` (type: `number`): Keep only tradies with an average rating at or above this value (0 = no filter). Rated 1-5. ## `minReviews` (type: `integer`): Keep only tradies with at least this many recommendations/reviews (0 = no filter). ## `withPhoneOnly` (type: `boolean`): Keep only tradies that expose a phone or mobile number — best for cold-call / SMS lead lists. ## `licensedOnly` (type: `boolean`): Keep only tradies flagged by hipages as holding a trade licence. ## `validAbnOnly` (type: `boolean`): Keep only tradies with a verified Australian Business Number (ABN). ## `includeBusinessDetails` (type: `boolean`): Visit each tradie's profile page to add the deep fields: ABN number + ABR verification link, full aggregate rating, the service catalogue and review texts. One extra request per tradie. Phone, rating, licence and headline already come from the listing. ## `includeServices` (type: `boolean`): Include the list of services each tradie offers (from their profile's service catalogue). Requires business details. ## `includeReviews` (type: `boolean`): Also output review records (type `review`) from each tradie's profile — star rating, review text and author. Requires business details. ## `maxReviewsPerBusiness` (type: `integer`): How many reviews to emit per tradie when 'Include reviews' is on (profiles expose roughly the 10 most recent). ## `includeJobLeads` (type: `boolean`): Also output recent homeowner job-request records (type `job`) shown on each listing page — the job description, suburb and postcode. These are demand-side leads (people actively looking to hire a tradie). ## `expandNearbySuburbs` (type: `boolean`): hipages has no deep page-by-page pagination, so coverage comes from breadth. Turn this on to automatically follow the 'nearby suburbs' on each listing and collect tradies from them too (same trade). ## `maxNearbySuburbs` (type: `integer`): When 'Expand into nearby suburbs' is on, how many adjacent suburbs to add per starting suburb. ## `deduplicateBusinesses` (type: `boolean`): Emit each tradie only once per run (keyed by business id / slug), even if they appear across multiple trades, suburbs or nearby-suburb expansions. ## `monitorMode` (type: `boolean`): Remember tradies already returned and emit ONLY ones not seen in previous runs. Pairs with Apify Schedules to track newly listed tradies in an area over time (no conflict — the schedule triggers the run, monitoring decides what's new). ## `monitorStoreName` (type: `string`): Named key-value store that holds the 'already seen' business ids for monitoring mode. Use a different name per tracked search to keep histories separate. ## `maxConcurrency` (type: `integer`): Maximum parallel requests. Lower it if you hit rate limits on very large runs. ## `proxyConfiguration` (type: `object`): Proxy settings. hipages serves clean pages, so the default Apify proxy works; for very large or high-frequency runs, switch to Residential with country AU for best consistency. ## Actor input object example ```json { "categories": [ "plumbers" ], "locations": [ "Sydney, NSW" ], "maxResults": 100, "maxBusinessesPerSearch": 60, "minRating": 0, "minReviews": 0, "withPhoneOnly": false, "licensedOnly": false, "validAbnOnly": false, "includeBusinessDetails": true, "includeServices": true, "includeReviews": false, "maxReviewsPerBusiness": 20, "includeJobLeads": false, "expandNearbySuburbs": false, "maxNearbySuburbs": 5, "deduplicateBusinesses": true, "monitorMode": false, "monitorStoreName": "hipages-monitor", "maxConcurrency": 5, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `results` (type: `string`): All scraped records in the default dataset. Business rows carry the full tradie profile, contact, ABN, ratings, services and lead score; review and job rows carry their own fields. # 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 = { "categories": [ "plumbers" ], "locations": [ "Sydney, NSW" ] }; // Run the Actor and wait for it to finish const run = await client.actor("scrapesage/hipages-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 = { "categories": ["plumbers"], "locations": ["Sydney, NSW"], } # Run the Actor and wait for it to finish run = client.actor("scrapesage/hipages-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 '{ "categories": [ "plumbers" ], "locations": [ "Sydney, NSW" ] }' | apify call scrapesage/hipages-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapesage/hipages-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Hipages Scraper - Australian Tradie & Home Services Leads", "description": "Scrape hipages tradies & home-service businesses by trade and suburb, or from profile URLs. Get name, phone & mobile, ABN, licence flag, star rating & reviews, services, headline and a lead score. Monitoring, no login, no key, no browser.", "version": "0.1", "x-build-id": "kuVJL8Vr4HEQmBpI3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapesage~hipages-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapesage-hipages-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/scrapesage~hipages-scraper/runs": { "post": { "operationId": "runs-sync-scrapesage-hipages-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/scrapesage~hipages-scraper/run-sync": { "post": { "operationId": "run-sync-scrapesage-hipages-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": { "categories": { "title": "Trades / categories", "type": "array", "description": "Trade categories to search: e.g. plumbers, electricians, carpenters, painters, builders, tilers, plasterers, bricklayers, concreting, fencing, landscaping, roofing, gardening, handyman, gas_fitters, cabinet_makers, air_conditioning, pest_control, cleaning, removalists. Friendly words (plumber, sparky, aircon, removals) auto-map; any valid hipages category slug also works. Each category is combined with every location.", "items": { "type": "string" } }, "locations": { "title": "Locations (Suburb, STATE)", "type": "array", "description": "Australian suburb + state, e.g. `Sydney, NSW`, `Bondi, NSW`, `Melbourne, VIC`, `Brisbane, QLD`. A suburb is required (hipages has no state-only listing). A bare state (`NSW`) or a bare capital city (`Perth`) is accepted and resolves to that capital. States: NSW, VIC, QLD, WA, SA, TAS, ACT, NT.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs (listing or profile pages)", "type": "array", "description": "Paste hipages listing URLs (`https://hipages.com.au/find///`) or tradie profile URLs (`https://hipages.com.au/connect/`). Processed in addition to the categories + locations above.", "items": { "type": "string" } }, "maxResults": { "title": "Max results (whole run)", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Global cap on the number of business records emitted in this run, across all searches and Start URLs.", "default": 100 }, "maxBusinessesPerSearch": { "title": "Max businesses per search", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Cap the number of tradies collected per trade + suburb page. Each hipages suburb page lists roughly 15-20 top-ranked tradies.", "default": 60 }, "minRating": { "title": "Minimum star rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Keep only tradies with an average rating at or above this value (0 = no filter). Rated 1-5.", "default": 0 }, "minReviews": { "title": "Minimum review count", "minimum": 0, "type": "integer", "description": "Keep only tradies with at least this many recommendations/reviews (0 = no filter).", "default": 0 }, "withPhoneOnly": { "title": "Only tradies with a phone number", "type": "boolean", "description": "Keep only tradies that expose a phone or mobile number — best for cold-call / SMS lead lists.", "default": false }, "licensedOnly": { "title": "Only licensed tradies", "type": "boolean", "description": "Keep only tradies flagged by hipages as holding a trade licence.", "default": false }, "validAbnOnly": { "title": "Only tradies with a valid ABN", "type": "boolean", "description": "Keep only tradies with a verified Australian Business Number (ABN).", "default": false }, "includeBusinessDetails": { "title": "Open each profile for full details", "type": "boolean", "description": "Visit each tradie's profile page to add the deep fields: ABN number + ABR verification link, full aggregate rating, the service catalogue and review texts. One extra request per tradie. Phone, rating, licence and headline already come from the listing.", "default": true }, "includeServices": { "title": "Include services list", "type": "boolean", "description": "Include the list of services each tradie offers (from their profile's service catalogue). Requires business details.", "default": true }, "includeReviews": { "title": "Include reviews", "type": "boolean", "description": "Also output review records (type `review`) from each tradie's profile — star rating, review text and author. Requires business details.", "default": false }, "maxReviewsPerBusiness": { "title": "Max reviews per tradie", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many reviews to emit per tradie when 'Include reviews' is on (profiles expose roughly the 10 most recent).", "default": 20 }, "includeJobLeads": { "title": "Include homeowner job requests (demand-side leads)", "type": "boolean", "description": "Also output recent homeowner job-request records (type `job`) shown on each listing page — the job description, suburb and postcode. These are demand-side leads (people actively looking to hire a tradie).", "default": false }, "expandNearbySuburbs": { "title": "Expand into nearby suburbs", "type": "boolean", "description": "hipages has no deep page-by-page pagination, so coverage comes from breadth. Turn this on to automatically follow the 'nearby suburbs' on each listing and collect tradies from them too (same trade).", "default": false }, "maxNearbySuburbs": { "title": "Max nearby suburbs per search", "minimum": 0, "maximum": 30, "type": "integer", "description": "When 'Expand into nearby suburbs' is on, how many adjacent suburbs to add per starting suburb.", "default": 5 }, "deduplicateBusinesses": { "title": "Deduplicate businesses", "type": "boolean", "description": "Emit each tradie only once per run (keyed by business id / slug), even if they appear across multiple trades, suburbs or nearby-suburb expansions.", "default": true }, "monitorMode": { "title": "Monitoring mode — only new tradies", "type": "boolean", "description": "Remember tradies already returned and emit ONLY ones not seen in previous runs. Pairs with Apify Schedules to track newly listed tradies in an area over time (no conflict — the schedule triggers the run, monitoring decides what's new).", "default": false }, "monitorStoreName": { "title": "Monitor store name", "type": "string", "description": "Named key-value store that holds the 'already seen' business ids for monitoring mode. Use a different name per tracked search to keep histories separate.", "default": "hipages-monitor" }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum parallel requests. Lower it if you hit rate limits on very large runs.", "default": 5 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. hipages serves clean pages, so the default Apify proxy works; for very large or high-frequency runs, switch to Residential with country AU for best consistency.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } } ```