# TrustRadius API — B2B software reviews, ratings & product profiles from trustradius.com and GetApp

> Fetch verified user reviews and ratings for a B2B software product from TrustRadius (up to 639 reviews with full verbatim text, reviewer job title, company industry and size) or GetApp. Filter by public-only or include all review visibility levels.
> ReefAPI engine `trustradius` · 3 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/trustradius/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 /trustradius/v1/product/reviews — 1 credit
Fetch verified user reviews and ratings for a B2B software product from TrustRadius (up to 639 reviews with full verbatim text, reviewer job title, company industry and size) or GetApp. Filter by public-only or include all review visibility levels.

**Parameters:**
- `product_slug` (string, required) — Product slug on the source site (the URL segment, e.g. 'slack'). Resolve one from a URL via the product/resolve action.
- `source` (enum, optional, default "trustradius") — Review platform to fetch from. Defaults to trustradius.com (full pagination, up to 639 reviews). getapp requires category_path and returns a partial page snapshot. capterra and g2 are not currently available. [one of: trustradius, getapp, capterra, g2]
- `skip` (integer, optional, default 0) — Number of reviews to skip (pagination offset; TrustRadius skip/limit mode).
- `limit` (integer, optional) — Reviews per page (1-100). Omit (or set fetch_all) to pull everything.
- `fetch_all` (boolean, optional, default false) — TrustRadius: fetch ALL reviews in one pass (ignores skip/limit).
- `include_non_public` (boolean, optional, default false) — Include reviews not marked public (default false = public only).
- `category_path` (string, optional) — GetApp-only: the category/product path (e.g. 'collaboration-software/a/slack/reviews/'). Required when source=getapp.

**Returns:** source, product_slug, reviews[] (title, rating_overall, verbatims, reviewer job_type/company_industry/company_size, …), pagination, pages_fetched, public_only

**Example request body:**
```json
{
  "source": "trustradius",
  "product_slug": "slack",
  "fetch_all": true
}
```

### POST /trustradius/v1/product/detail — 1 credit
product metadata (rating, category, vendor)

**Parameters:**
- `product_slug` (string, required) — Product slug on the source site (the URL segment, e.g. 'slack'). Resolve one from a URL via the product/resolve action.
- `source` (enum, optional, default "trustradius") — Review platform to fetch from. Defaults to trustradius.com (full pagination, up to 639 reviews). getapp requires category_path and returns a partial page snapshot. capterra and g2 are not currently available. [one of: trustradius, getapp, capterra, g2]
- `category_path` (string, optional) — GetApp-only: the category/product path (e.g. 'collaboration-software/a/slack/reviews/'). Required when source=getapp.

**Returns:** source, product{} — name, slug, rating_avg, review_count, category, vendor

**Example request body:**
```json
{
  "product_slug": "slack"
}
```

### POST /trustradius/v1/product/resolve — 0 credits
resolve a TrustRadius/GetApp/Capterra/G2 URL → source + slug

**Parameters:**
- `url` (string, required) — A TrustRadius / GetApp / Capterra / G2 product URL to parse into {source, product_slug}.

**Returns:** source, product_slug (plus product_id, category_path, or availability note depending on the platform)

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