Revdict.

Revdict API

Submit a Google Maps place URL and get back a fake-review report as JSON: a 0–100 manipulation score, a verdict, the signals behind it and the individual reviews that were flagged. The same engine runs the analyzer on the home page.

Overview

  • Base URL: https://revdict.com/api/v1
  • Authentication: none. No API key, no sign-up. Send Accept: application/json.
  • Rate limit: 60 requests per minute per IP address. Over the limit the API answers 429 Too Many Requests with a Retry-After header; every response carries X-RateLimit-Limit and X-RateLimit-Remaining.
  • Format: JSON request and response bodies, UTF-8, timestamps in ISO 8601 UTC.
  • Price: free. HTTPS only. CORS is open (Access-Control-Allow-Origin: *), so you can call it from a browser.

Quick start

Submit a place, then poll the returned id until status is completed or failed. A fresh analysis usually takes a few minutes.

curl -s -X POST https://revdict.com/api/v1/analyses \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"url": "https://www.google.com/maps/place/Example+Cafe/@40.71,-74.00,17z"}'

curl -s https://revdict.com/api/v1/analyses/01kxdsz8z4yp8m54nxs1h73wvx \
  -H 'Accept: application/json'

POST /api/v1/analyses

Submit a Google Maps place URL for analysis.

FieldTypeRules
url string Required. Must start with https://www.google.com/maps, https://google.com/maps or https://maps.app.goo.gl. Short links are expanded. Use the URL of a place page (/maps/place/…); search or coordinate-only URLs fail the analysis.

202 Accepted: a new analysis was queued. Poll it with GET /api/v1/analyses/{id}.

{
  "data": {
    "id": "01kxdsz8z4yp8m54nxs1h73wvx",
    "status": "pending",
    "input_url": "https://www.google.com/maps/place/Example+Cafe/@40.71,-74.00,17z",
    "score": null,
    "verdict": null,
    "reasons": null,
    "started_at": null,
    "completed_at": null
  }
}

200 OK: a completed report for the same URL or place is younger than 7 days. It is returned in full (same body as the report) and no new crawl starts. Reports are shared: everyone who submits that place within the window gets the same report.

422 Unprocessable Entity: url is missing or is not a Google Maps URL. The body lists the errors under errors.url.

GET /api/v1/analyses/{id}

Read the status of an analysis. Anyone who knows the id can read it. Status goes pending → fetching_reviews → fetching_reviewers → scoring → completed, or ends in failed with an error message. While it runs only the status fields are filled; once completed the body adds place, review_summary and flagged_reviews. Poll every 10–15 seconds. The human-readable report lives at https://revdict.com/a/{id}.

{
  "data": {
    "id": "01kxdsz8z4yp8m54nxs1h73wvx",
    "status": "completed",
    "input_url": "https://www.google.com/maps/place/Example+Cafe/@40.71,-74.00,17z",
    "score": 74,
    "verdict": "likely_manipulated",
    "reasons": [
      { "code": "burst", "weight": 1.0, "detail": "14 five-star reviews on 2026-03-12 vs avg 0.4/day" }
    ],
    "review_summary": {
      "overview": "Reviewers praise fast service; noise is the most repeated drawback.",
      "strengths": [{ "topic": "Fast service", "summary": "Short waits.", "review_ids": ["..."] }],
      "complaints": [],
      "good_for": ["Quick casual meals"],
      "avoid_if": ["You need a quiet room"],
      "recent_changes": null,
      "reviews_analyzed": 186,
      "date_from": "2025-08-01",
      "date_to": "2026-07-12",
      "model": "..."
    },
    "place": {
      "google_place_id": "ChIJ...",
      "name": "Example Cafe",
      "address": "1 Example St, New York, NY",
      "country": "US",
      "category": "Cafe",
      "url": "https://www.google.com/maps/place/Example+Cafe/@40.71,-74.00,17z",
      "rating": "4.6",
      "reviews_count": 240,
      "last_fetched_at": "2026-07-13T13:16:57.000000Z"
    },
    "flagged_reviews": [
      {
        "suspicion_score": 100,
        "signals": [
          { "code": "burst", "score": 80, "detail": "part of 14 five-star reviews on 2026-03-12 vs avg 0.4/day" },
          { "code": "low_activity_account", "score": 80, "detail": "5-star review from low-activity account (1 total reviews, not a Local Guide, no photos)" }
        ],
        "review": {
          "google_review_id": "...",
          "rating": 5,
          "text": "...",
          "lang": "en",
          "published_at": "2026-03-12T08:05:00.000000Z",
          "likes_count": 0,
          "photos": []
        },
        "reviewer": {
          "name": "...",
          "profile_pic_url": "...",
          "is_local_guide": false,
          "reviews_total": 1,
          "photos_total": 0
        }
      }
    ],
    "started_at": "2026-07-13T13:14:49.000000Z",
    "completed_at": "2026-07-13T13:16:57.000000Z"
  }
}
FieldDescription
scoreComposite manipulation score, 0–100.
verdictclean (below 40), suspicious (40 or more), likely_manipulated (70 or more).
reasonsOne entry per signal that fired at place level: code, scorer weight and a plain-language detail.
review_summaryAI-written summary of the reviews that were not flagged; null when there are not enough of them.
flagged_reviews[]Each flagged review with its suspicion_score (0–100), the signals that flagged it, the review and public reviewer profile counts.
errorOnly when status is failed.

Signal codes and how each one is computed are on the methodology page. 404: unknown id.

POST /api/v1/analyses/{id}/notify

Leave an email address to get the verdict by email when the analysis finishes. If it has already finished, the email goes out at once. The address is used for this one message and never appears in any API response.

curl -s -X POST https://revdict.com/api/v1/analyses/01kxdsz8z4yp8m54nxs1h73wvx/notify \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"email": "[email protected]"}'

{"ok": true}

404: unknown id. 422: invalid email.

Using the results

A score is a statistical estimate of review patterns, not proof that a business bought reviews. If you publish results, attribute them to Revdict's analysis and link the report page. See the terms of use. For aggregate figures across all analyzed places use the public dataset (CSV and JSON). Questions or a higher limit: contact us.