Hipages Business Extractor

This actor scrapes business listings from Hipages, Australia's home improvement marketplace. It extracts detailed profiles, reviews, and contact information for tradespeople across over 120 service categories, based on location and sorting preferences. The output is structured JSON data suitable for lead generation, market research, or integration into other systems.

Key Features

• Targeted Searches: Filter by one of 120+ service categories (e.g., Plumbers, Electricians) and by Australian postcode.
• Sortable Results: Order results by star rating, total times hired, or total recommendations.
• Comprehensive Data Extraction: Captures a full business profile including:
  • Business name, phone, and mobile numbers.
  • Service area and license/ABN verification status.
  • Star ratings, review counts, and engagement metrics.
  • Customer recommendations with comments.
  • Business highlights and specialties.
  • Direct URL to the Hipages profile.

How to Use

Provide input to the actor via a JSON object. The actor requires a category and a postcode. The sortBy parameter is optional.

Input

{
  "category": "Air Conditioning",
  "postcode": 2213,
  "sortBy": "Total Hired"
}

• category: The service category to search within (e.g., "Plumbing", "Building").
• postcode: An Australian postcode to define the search location.
• sortBy (optional): How to sort results. Options are "Star Rating", "Total Hired", or "Total Recommendations".

Output

The actor returns an array of business objects in JSON format. Below is an example of a single extracted business profile.

{
  "name": "Frost Tech",
  "hasLicense": 1,
  "hasValidAbn": 1,
  "serviceArea": "EAST HILLS",
  "totalRecommendations": 4,
  "phone": "0420616337",
  "mobile": "0420616337",
  "headline": "Professional local Air Conditioning business with over a decades experience.",
  "highlights": [
    "Quality Workmanship Guaranteed",
    "Commercial & Residential",
    "Competitive Quotes"
  ],
  "recommendations": {
    "comment": "Tradie best price and did extra services without charge. Easy to deal with too...",
    "jobPostcode": 2017,
    "userName": "Han"
  },
  "starRating": {
    "rating": 5,
    "totalHired": 4,
    "totalRatings": 3
  },
  "profilePageFullUrl": "https://hipages.com.au/connect/frosttech2"
}

Limitations & Error Handling

• Hipages limits results to a maximum of 110 businesses per search query.
• Some field data may be missing if not provided on the source profile.
• The actor includes error handling for:
  • Invalid postcodes (falls back to a default Sydney suburb).
  • Invalid categories (defaults to "Air Conditioning").
  • API response changes (gracefully handles missing fields).
  • Network issues (implements retry logic for failed requests).

For support, please create an issue.