API Documentation

GhostReview™ API Reference

Integrate AI-powered review analysis into your applications. Detect fake reviews, analyze sentiment, and protect your brand reputation programmatically.

API Access Available for Agency Plan

API access is now available exclusively for Agency plan subscribers. Upgrade to Agency plan to get programmatic access to all GhostReview features with 5,000 requests per month.

Quick Start

Get started with the GhostReview API in minutes

1

Get your API key

Upgrade to Agency plan, then go to Dashboard → Settings → API Keys

2

Make your first request

Use POST /api/v1/analyze to scan your first review

3

Integrate and scale

Build powerful reputation management features into your app (5,000 req/month)

Base URL

https://ghost-review.com/api/v1

Authentication

Authorization: Bearer YOUR_API_KEY

API Endpoints

POST/api/v1/analyze

Analyze a review text and get AI-powered suspicion scoring, classification, and summary. This endpoint uses Google Gemini AI to detect fake reviews and provide detailed analysis.

Request

Headers

Content-Type: application/jsonAuthorization: Bearer YOUR_API_KEY

Body Parameters

reviewTextstringRequired

The review text to analyze (max 5000 characters)

platformstringRequired

Review platform: 'google', 'yelp', or 'tripadvisor' (lowercase)

Example Request

curl -X POST https://ghost-review.com/api/v1/analyze \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "reviewText": "Amazing service! Best experience ever!",
    "platform": "google"
  }'

Response

Response Fields

successboolean

Indicates if the request was successful

data.reviewIdstring

Unique identifier for this analysis

data.suspicionScorenumber

Suspicion score from 0-100 (0=authentic, 100=fake)

data.classificationstring

Classification: 'Authentic', 'Possibly Manipulated', or 'Likely Fake'

data.summarystring

AI-generated summary explaining the analysis

data.criteriaScoresobject

Detailed scoring for emotionRange, specificity, grammar, repetition, toneBalance

data.platformstring

The platform the review was from

data.analyzedAtstring

ISO 8601 timestamp of analysis

Example Response

{
  "success": true,
  "data": {
    "reviewId": "cm5abc123xyz",
    "suspicionScore": 87,
    "classification": "Likely Fake",
    "summary": "Repetitive phrasing, unnatural tone, excessive enthusiasm without specific details.",
    "criteriaScores": {
      "emotionRange": 85,
      "specificity": 90,
      "grammar": 75,
      "repetition": 95,
      "toneBalance": 88
    },
    "platform": "google",
    "analyzedAt": "2025-01-21T10:30:00.000Z"
  }
}

Rate Limits

API rate limits vary by subscription plan

Free Plan

5 scans/month

No API access

Pro Plan

50 scans/month

No API access

Agency Plan

5,000 requests/month

Full API Access

Error Codes

Standard HTTP status codes and error responses

400

Bad Request

Invalid request parameters or missing required fields

401

Unauthorized

Invalid or missing API key

403

Forbidden

API key doesn't have permission for this resource

429

Too Many Requests

Rate limit exceeded for your plan

500

Internal Server Error

Something went wrong on our end