# HelloPeter South Africa Business Reviews API

> Search South African businesses on HelloPeter: star rating, review count, claim status, logo

- Vendor: `hellopetersouthafricabusinessr` · version 1.0 · category Business · tags hellopeter api, south africa reviews api, business reviews api, company rating api, customer complaints api, reputation api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/hellopetersouthafricabusinessr
- This document: https://apiclay.com/docs/hellopetersouthafricabusinessr.md
- OpenAPI 3.1: https://apiclay.com/api/hellopetersouthafricabusinessr/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `hellopetersouthafricabusinessr`
- Updated: 2026-11-18

## About

## HelloPeter South Africa Business Reviews API

Search HelloPeter, South Africa's main customer review and complaints site, by business name and get each match's average star rating, number of reviews, whether the business has claimed or verified its profile, its logo and HelloPeter slug.

Data comes from **hellopeter.com** (https://www.hellopeter.com). Every route calls the source's own public JSON endpoint (found with the live-URL scan of https://www.hellopeter.com) and returns it unchanged.

Typical flow: `/search?q=vodacom`.

### Routes

#### GET `/search` - Search businesses
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| q | query | string | yes | Business name or part of it, e.g. `vodacom`. |

Returns: `results[]` with `id`, `name`, `slug`, `rating` (1-5), `reviewCount`, `status` (`verified`, `claimed`, `unclaimed`), `logo`, `website`.

The business page is `https://www.hellopeter.com/`.

### Caveats

- Name search only (about 20 matches); individual reviews are not included.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by hellopeter.com.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /search — Search businesses
- Gateway: `GET https://api.apiclay.com/v1/api/hellopetersouthafricabusinessr/search`
- Public query params: `q` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/hellopetersouthafricabusinessr/search?q=<q>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
