HelloPeter APIhellopeter.com ↗
Access HelloPeter business reviews, trust index scores, NPS data, and company profiles via a simple REST API. Covers South Africa's top consumer review platform.
What is the HelloPeter API?
The HelloPeter API exposes two endpoints covering business reviews and business profile data from South Africa's largest consumer review platform. The get_business_reviews endpoint returns paginated reviews with author details, star ratings, full review text, and business reply messages, while get_business_info returns trust index scores, NPS distributions, industry rankings, and verification status for any business identified by its slug.
curl -X GET 'https://api.parse.bot/scraper/3932a679-fdec-421b-bcf4-8c2f8a8b0910/get_business_reviews?date_posted=last_12_months&business_slug=vodacom' \ -H 'X-API-Key: $PARSE_API_KEY'
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.
| Param | Type | Description |
|---|---|---|
| cursor | string | Pagination cursor from a previous response's next_cursor field. Omit or leave empty for the first page. |
| keyword | string | Search keyword to filter reviews by content. |
| ratings | string | Filter by star rating (1-5). Pass a single digit e.g. '5' for 5-star reviews only. |
| date_posted | string | Time period filter for reviews. When omitted, defaults to last 12 months. |
| business_slugrequired | string | URL slug of the business on HelloPeter (e.g. 'vodacom', 'telkom', 'fnb'). This is the path segment from the business page URL. |
{
"type": "object",
"fields": {
"reviews": "array of review objects with id, author, rating, title, content, messages, and metadata",
"next_cursor": "string cursor for the next page, or null if no more results"
},
"sample": {
"data": {
"reviews": [
{
"id": 6546856,
"title": "FIBRE- 9 DAYS CONNECTED WITH NO INTERNET",
"author": "Oratile M",
"rating": 1,
"source": "WEBSITE",
"content": "Our fibre/router has not connected us to the internet since the 8th of Aug...",
"replied": 0,
"messages": [],
"author_id": "59178130-169d-11ef-8835-bf1a5b0fc77c",
"permalink": "fibre-9-days-connected-with-no-internet-6546856",
"created_at": "2026-08-18 15:53:43",
"business_name": "Vodacom",
"business_slug": "vodacom",
"author_total_reviews_count": 2
}
],
"next_cursor": "eyJpZCI6NjU0NTAyOCwiX3BvaW50c1RvTmV4dEl0ZW1zIjp0cnVlfQ"
},
"status": "success"
}
}About the HelloPeter API
What the API Returns
The HelloPeter API covers two primary resources. get_business_reviews retrieves up to 11 reviews per page for any business identified by its business_slug (e.g. 'vodacom', 'fnb'). Each review object includes an id, author, rating (1–5 stars), title, content, messages (business reply threads), and associated metadata. Cursor-based pagination is handled via the next_cursor field returned in each response — pass it back as the cursor parameter to fetch the next page.
Filtering Reviews
get_business_reviews supports three optional filters. The ratings parameter narrows results to a single star value (pass '5' for five-star reviews only). The keyword parameter searches review content by a text string. The date_posted parameter restricts results to a time period; when omitted, it defaults to the last 12 months. These filters can be combined to isolate specific feedback segments.
Business Profile Data
get_business_info returns a profile summary keyed on business_slug. Response fields include trust_index (a numeric score from 1–10), business_name, industry_name, industry_slug, is_verified (whether the business holds a paid/verified account), logo (a URL to the business logo image), website, keywords (popular search terms associated with the business), and nps (an array of NPS score distribution buckets). This endpoint is useful for snapshot reputation assessments without needing to paginate through individual reviews.
The HelloPeter API is a managed, monitored endpoint for hellopeter.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when hellopeter.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official hellopeter.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Monitor trust index scores and NPS distributions for South African businesses over time
- Aggregate one-star reviews using the
ratingsfilter to surface recurring customer complaints - Compare
is_verifiedstatus and industry rankings across competitors in the sameindustry_slug - Search review content by
keywordto track mentions of a specific product, feature, or incident - Pull business reply messages from review threads to evaluate customer service responsiveness
- Build a brand reputation dashboard using
trust_index,nps, and review volume data - Enrich a B2B directory with consumer sentiment data by matching business slugs to company records
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does HelloPeter have an official developer API?+
How does pagination work in get_business_reviews?+
next_cursor field. Pass that value as the cursor parameter on your next request to retrieve the following page. When next_cursor is null, you have reached the last page. Omit cursor entirely to start from the first page.Does get_business_reviews return reviews older than 12 months?+
date_posted is omitted, the endpoint defaults to the last 12 months of reviews. HelloPeter does allow browsing older reviews on the site. The current API defaults to this 12-month window; you can fork the API on Parse and revise the date_posted parameter handling to expose older date ranges if your use case requires historical data.Does the API return individual reviewer profiles or review helpfulness votes?+
Can I retrieve a list of all businesses or browse by industry using this API?+
business_slug as input — there is no search-by-industry or list-all-businesses endpoint currently included. get_business_info does return industry_name and industry_slug for a given business. You can fork the API on Parse and revise it to add an industry browsing or business search endpoint.