# Hellopeter — 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.

> Access business reviews, ratings, and detailed company information from South Africa's trusted HelloPeter platform to research consumer feedback and make informed decisions about local businesses. Get comprehensive insights into what customers are saying about any business, including their overall ratings and key details.

**Category:** Reviews & Ratings | **Website:** [www.hellopeter.com/](https://www.hellopeter.com/) | **Docs:** [parse.bot/marketplace/01d81546-1dda-475d-8b0d-16b7f6cbcd0e/hellopeter-com-api](https://parse.bot/marketplace/01d81546-1dda-475d-8b0d-16b7f6cbcd0e/hellopeter-com-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-hellopeter-com-api-01d81546/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_business_info

Retrieve business profile information from HelloPeter including trust index rating, total review count, industry ranking, response metrics, and NPS score distribution. Provides a summary of the business's reputation on the platform.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `business_slug` | string | Yes | URL slug of the business on HelloPeter (e.g. 'vodacom', 'telkom', 'fnb'). This is the path segment from the business page URL. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hellopeter-com-api-01d81546/get_business_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"business_slug":"<string>"}'
```

### get_business_reviews

Retrieve reviews for a business on HelloPeter by its URL slug. Returns paginated reviews (11 per page) with cursor-based pagination. Supports filtering by star rating, keyword search, and date range. Each review includes the author, rating, content, business reply messages, and metadata. Pass the next_cursor value from a previous response to get the next page of results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `business_slug` | string | Yes | URL slug of the business on HelloPeter (e.g. 'vodacom', 'telkom', 'fnb'). This is the path segment from the business page URL. |
| `cursor` | string | No | Pagination cursor from a previous response's next_cursor field. Omit or leave empty for the first page. |
| `date_posted` | string | No | Time period filter for reviews. When omitted, defaults to last 12 months. |
| `keyword` | string | No | Search keyword to filter reviews by content. |
| `ratings` | string | No | Filter by star rating (1-5). Pass a single digit e.g. '5' for 5-star reviews only. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hellopeter-com-api-01d81546/get_business_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"business_slug":"<string>","cursor":"<string>","date_posted":"<string>","keyword":"<string>","ratings":"<string>"}'
```