# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/hellopeter/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/hellopeter/get-business-info \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/hellopeter/get-business-reviews \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"business_slug":"<string>","cursor":"<string>","date_posted":"<string>","keyword":"<string>","ratings":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.