Developer Docs

RatingHub Public API

Embed real trust signals on your website. Show your DNA score, recent reviews, and our Rated-on-RatingHub badge with a single API call.

Getting Started

The RatingHub Public API is REST-based and returns JSON. All endpoints are served over HTTPS. No API key is required for basic usage, but authenticated requests get higher rate limits.

No API key needed for basic use

CORS enabled — call from any origin

SVG + HTML widget included

Base URL

text

https://theratinghub.com/api/public/v1

Authentication

Pass your API key in the X-API-Key header. Keys can be generated from your dashboard.

bash

curl https://theratinghub.com/api/public/v1/company/cloudcraft-au \
  -H "X-API-Key: rh_your_key_here"

Rate Limits

Tier	Limit	Auth
Anonymous	100 req/min	None
API Key	1,000 req/min	X-API-Key header
Partner	Custom	Contact us

Rate limit status is returned in X-Rate-Limit-Remaining header.

Endpoints

Company

GET

/company/:slug

Full company data with DNA scores and recent reviews

GET

/widget/:slug

Embeddable widget (SVG, HTML, or JSON). Accepts ?format= and ?theme=

GET /company/:slug

bash

curl https://theratinghub.com/api/public/v1/company/cloudcraft-au

json

{
  "company": {
    "id": "clx...",
    "name": "CloudCraft AU",
    "slug": "cloudcraft-au",
    "tagline": "Build, deploy and scale at the speed of thought",
    "overallScore": 82,
    "performanceScore": 88,
    "valueScore": 75,
    "reliabilityScore": 91,
    "supportScore": 79,
    "experienceScore": 77,
    "reviewCount": 128,
    "isVerified": true,
    "isPremium": true,
    "category": { "name": "SaaS", "slug": "saas" }
  },
  "recentReviews": [
    { "id": "...", "title": "Excellent platform", "overallScore": 88, "createdAt": "..." }
  ],
  "meta": {
    "generatedAt": "2026-06-17T00:00:00.000Z",
    "profileUrl": "https://theratinghub.com/company/cloudcraft-au",
    "widgetUrl": "https://theratinghub.com/api/public/v1/widget/cloudcraft-au"
  }
}

V2 Endpoints

New

Version 2 exposes richer data: full DNA breakdowns per review, paginated review lists, company discovery, and more. Same authentication and rate limits as v1.

Base URL

text

https://theratinghub.com/api/public/v2

V2 Routes

GET

/company/:slug

Enhanced company profile with dnaBreakdown object, recentReviews, and mostHelpfulReviews

GET

/reviews?companySlug=...

Paginated reviews with full DNA scores, pros/cons/tags, and author trust info

GET

/companies?category=...

Paginated company discovery with search, category filter, and sort options

GET /v2/reviews

Required: companySlug. Optional: page, limit (max 50), sort (recent|high|low)

bash

curl "https://theratinghub.com/api/public/v2/reviews?companySlug=cloudcraft-au&page=1&limit=10&sort=recent"

json

{
  "company": { "name": "CloudCraft AU", "slug": "cloudcraft-au" },
  "reviews": [
    {
      "id": "clx...",
      "title": "Best cloud platform for startups",
      "body": "We migrated from AWS and halved our infrastructure costs...",
      "overallScore": 88,
      "performanceScore": 92,
      "valueScore": 84,
      "reliabilityScore": 91,
      "supportScore": 83,
      "experienceScore": 85,
      "tags": ["cloud", "devops", "pricing"],
      "pros": ["Fast deploys", "Great DX", "Transparent pricing"],
      "cons": ["Limited AU regions"],
      "helpfulCount": 14,
      "isVerifiedPurchase": true,
      "author": { "name": "Sarah K.", "trustScore": 91, "isVerifiedProfessional": true },
      "reviewUrl": "https://theratinghub.com/company/cloudcraft-au#review-clx..."
    }
  ],
  "pagination": { "page": 1, "limit": 10, "total": 128, "pages": 13, "hasNext": true },
  "meta": { "generatedAt": "2026-06-20T00:00:00.000Z", "apiVersion": "v2" }
}

GET /v2/companies

Optional: q, category (slug), sort (score|reviews|newest), page, limit

bash

curl "https://theratinghub.com/api/public/v2/companies?category=saas&sort=score&limit=10"

Widget Badge

Our widget endpoint returns a ready-to-embed badge showing your DNA score. Supports three formats:

SVG

SVG Image

Embed as <img> tag. Cached by browser.

HTML

HTML Widget

Rich interactive badge via <iframe>.

JSON

JSON Data

Raw data + pre-built embed code.

Parameters

Param	Values	Default
format	svg \| html \| json	svg
theme	light \| dark	light

Embed Code

SVG Image (simplest)

html

<img src="https://theratinghub.com/api/public/v1/widget/your-slug?format=svg"
     alt="Rated on RatingHub"
     width="280" height="96">

Interactive HTML Widget

html

<iframe
  src="https://theratinghub.com/api/public/v1/widget/your-slug?format=html&theme=light"
  width="280" height="96"
  frameborder="0" scrolling="no"
  style="border:none;overflow:hidden"
  title="Rated on RatingHub">
</iframe>

Dark Theme

html

<img src="https://theratinghub.com/api/public/v1/widget/your-slug?format=svg&theme=dark"
     alt="Rated on RatingHub" width="280" height="96">

Response Schema

DNA Score Fields (all 0–100)

overallScore

Weighted composite of all 5 DNA axes

performanceScore

Speed, efficiency, technical quality

valueScore

Value for money relative to alternatives

reliabilityScore

Uptime, consistency, trust over time

supportScore

Customer support quality and responsiveness

experienceScore

UX, ease of use, onboarding

Need help?

Our team is available for integration support and partnership enquiries.