# Hipages — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search for local service businesses on hipages.com.au, view detailed business profiles and customer reviews, and explore available service categories all in one place. Find the right tradesperson or service provider by browsing ratings, contact information, and customer feedback.

**Category:** Business Directories | **Website:** [hipages.com.au/](https://hipages.com.au/) | **Docs:** [parse.bot/marketplace/500e5945-ae7a-4e61-b6a8-17de9cde5085/hipages-com-au-api](https://parse.bot/marketplace/500e5945-ae7a-4e61-b6a8-17de9cde5085/hipages-com-au-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-hipages-com-au-api-500e5945/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_business_profile

Get full profile details of a business by its slug. Returns structured JSON-LD data including ABN, aggregate ratings, services offered, and sample reviews. The slug is the 'key' field from search_businesses results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Business slug from search_businesses results (the 'key' field, e.g. 'emcoelectricalservices'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hipages-com-au-api-500e5945/get_business_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_business_reviews

Get reviews and recommendations for a business. Returns review objects with author name, rating, and review body text extracted from the business profile page's JSON-LD. The slug is the 'key' field from search_businesses results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Business slug from search_businesses results (the 'key' field, e.g. 'emcoelectricalservices'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hipages-com-au-api-500e5945/get_business_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### list_categories

List all available trade categories and their URL slugs from hipages.com.au. Returns the complete set of trade categories. Use the returned slugs as the 'category' input to search_businesses.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hipages-com-au-api-500e5945/list_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_businesses

Search for businesses by trade category and location on hipages.com.au. Returns a paginated list of business listings including ratings, contact info, service area, and a sample recommendation. Paginated by integer page number. Each business carries a 'key' slug usable with get_business_profile and get_business_reviews.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Trade category slug (e.g. 'electricians', 'plumbers', 'air_conditioning'). Use list_categories to discover available slugs. |
| `city` | string | No | City name (e.g. 'sydney', 'melbourne', 'brisbane'). |
| `page` | integer | No | Page number for pagination, starting at 1. |
| `state` | string | No | Australian state or territory code. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hipages-com-au-api-500e5945/search_businesses \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","city":"<string>","page":"<integer>","state":"<string>"}'
```