# Sitejabber API — business reviews, ratings and TrustScore scraper: overall star rating, total review count, 5-to-1-star rating distribution, sub-ratings (service, value, shipping, returns, quality), and every customer review with rating, text, date, country, verified status, helpful votes and the business's reply — by domain, plus business search and category browse from Sitejabber.com (SmartCustomer), no API key required

> Get a business's customer reviews from Sitejabber by domain — paginated, 20 per page. Each review has the 1-5 star rating, title, full text, the five sub-ratings (service, value, shipping, returns, quality), date, the reviewer's country, verified status, products used, helpful/not-helpful vote counts and the business's reply. Page with `page` until meta.pagination.has_more is false.
> ReefAPI engine `sitejabber` · 5 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/sitejabber/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed or blocked calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http, `Authorization: Bearer <key>`) and your assistant can call these actions directly.

## Endpoints

### POST /sitejabber/v1/reviews — 1 credit
Get a business's customer reviews from Sitejabber by domain — paginated, 20 per page. Each review has the 1-5 star rating, title, full text, the five sub-ratings (service, value, shipping, returns, quality), date, the reviewer's country, verified status, products used, helpful/not-helpful vote counts and the business's reply. Page with `page` until meta.pagination.has_more is false.

**Parameters:**
- `domain` (string, required) — The business's website domain on Sitejabber, e.g. 'amazon.com' or 'nike.com' (a full sitejabber.com/reviews/<domain> URL also works).
- `page` (integer, optional, default 1) — Page number. Reviews are 20 per page — page until meta.pagination.has_more is false (meta.pagination.total tells you the total review count).

**Returns:** reviews[]{review_id, review_no, rating, title, text, tip, sub_ratings, date, experience_date, is_verified, helpful_votes, not_helpful_votes, comment_count, products_used, reviewer_name*, reviewer_country*, business_reply, photo_count, url} + business{name, domain, rating, review_count} + meta.pagination{page, per_page, total, has_more, next_page} (*reviewer name/country redacted by default; pass include_pii=true for full data)

**Example request body:**
```json
{
  "domain": "amazon.com"
}
```

### POST /sitejabber/v1/aggregate — 1 credit
The rating summary for a business by domain (no individual reviews) — overall star rating, total review count, the 5★→1★ rating distribution, and the five sub-rating averages (service, value, shipping, returns, quality). Cheaper than `reviews` when you only need the score.

**Parameters:**
- `domain` (string, required) — The business's website domain on Sitejabber, e.g. 'amazon.com' or 'nike.com' (a full sitejabber.com/reviews/<domain> URL also works).

**Returns:** business{name, domain, rating, review_count, sub_ratings} + rating_distribution{5_star..1_star} + total_reviews

**Example request body:**
```json
{
  "domain": "amazon.com"
}
```

### POST /sitejabber/v1/detail — 1 credit
The full business profile on Sitejabber by domain — name, website, founded year, industry, the AI summary of what customers say, categories, overall rating, total review count, sub-rating breakdown and the rating distribution.

**Parameters:**
- `domain` (string, required) — The business's website domain on Sitejabber, e.g. 'amazon.com' or 'nike.com' (a full sitejabber.com/reviews/<domain> URL also works).

**Returns:** business{business_id, name, domain, website, title, description, ai_summary, founded, subindustry, categories[], rating, review_count, sub_ratings, views} + rating_distribution{5_star..1_star} + similar_businesses[]{name, domain}

**Example request body:**
```json
{
  "domain": "nike.com"
}
```

### POST /sitejabber/v1/search — 1 credit
Search Sitejabber for businesses by name or keyword — returns matching businesses with name, domain, overall rating, total review count, industry and AI summary. 28 per page.

**Parameters:**
- `query` (string, required) — The business name or keyword to search for (e.g. 'amazon', 'shoes', 'vpn').
- `page` (integer, optional, default 1) — Page number. Reviews are 20 per page — page until meta.pagination.has_more is false (meta.pagination.total tells you the total review count).

**Returns:** businesses[]{business_id, name, domain, website, rating, review_count, subindustry, categories[]} + meta.pagination{page, total, has_more, next_page}

**Example request body:**
```json
{
  "query": "amazon"
}
```

### POST /sitejabber/v1/category — 1 credit
Browse the businesses listed in a Sitejabber category — returns each business's name, domain, rating, review count and industry, ranked. 10 per page; paginate with `page`. Pick a top-level category from the list, or pass any deeper sub-category slug from a sitejabber.com/categories/<slug> URL (e.g. 'banking', 'insurance', 'web-hosting', 'dating') — those work too.

**Parameters:**
- `category` (enum, required) — The Sitejabber category. Choose a top-level slug from the list, or type any deeper sub-category slug from a sitejabber.com/categories/<slug> URL — those resolve too. [one of: shopping, clothing-fashion, computers-technology, beauty, health, home-garden, food-drink, travel, finance, cryptocurrency, business, education, entertainment, autos-vehicles, real-estate, pets-animals, baby-kids, sports, hobbies-interests, art-design, relationships, jobs, law-government, news, science, society, reference, black-owned]
- `page` (integer, optional, default 1) — Page number. Reviews are 20 per page — page until meta.pagination.has_more is false (meta.pagination.total tells you the total review count).

**Returns:** businesses[]{business_id, name, domain, rating, review_count, subindustry, categories[]} + category{slug} + meta.pagination{page, total, has_more, next_page}

**Example request body:**
```json
{
  "category": "shopping"
}
```

## More
- Try it live, no code: https://reefapi.com/playground?engine=sitejabber
- Human docs page: https://reefapi.com/docs/sitejabber
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt