Developer Portal

import requests

# 1. Login to get JWT token
auth = requests.post("https://reviewsignal.ai/api/auth/login", json={
    "email": "you@company.com",
    "password": "your_password"
})
token = auth.json()["token"]
headers = {"Authorization": f"Bearer {token}"}

# 2. Get review-sentiment signals
signals = requests.get(
    "https://reviewsignal.ai/api/dashboard/signals",
    headers=headers
).json()

for s in signals["signals"][:5]:
    print(f"{s['chain']:20} {s['signal']:6} confidence={s['confidence']:.0%}")

# 3. Get sentiment overview
overview = requests.get(
    "https://reviewsignal.ai/api/dashboard/overview",
    headers=headers
).json()
print(f"Tracking {overview['total_locations']} locations, {overview['total_reviews']} reviews")

import requests

headers = {"X-API-Key": "rs_your_live_api_key"}

# Check account scope and remaining quota
account = requests.get(
    "https://reviewsignal.ai/api/v1/account",
    headers=headers
).json()
print(account["tier"], account["rate_limit_remaining"])

# Request one machine-to-machine signal
signal = requests.post(
    "https://reviewsignal.ai/api/v1/signal",
    headers=headers,
    json={"brand": "Starbucks"}
).json()
print(signal["signal"], signal["confidence"])

# Login
curl -X POST https://reviewsignal.ai/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"you@company.com","password":"your_password"}'

# Get review-sentiment signals (replace TOKEN)
curl https://reviewsignal.ai/api/dashboard/signals \
  -H "Authorization: Bearer TOKEN"

# Machine-to-machine account check (replace API key)
curl https://reviewsignal.ai/api/v1/account \
  -H "X-API-Key: rs_your_live_api_key"

# Same call, Bearer alias (accepted for /api/v1/*)
curl https://reviewsignal.ai/api/v1/account \
  -H "Authorization: Bearer rs_your_live_api_key"

pip install -e ./sdk/python

from reviewsignal import ReviewSignalClient

client = ReviewSignalClient()
client.login("you@company.com", "your_password")

overview = client.dashboard_overview(category="Coffee")
signals = client.dashboard_signals(signal_type="BUY", per_page=10)
subscription = client.billing_subscription()

print(overview["total_reviews"], signals["total"], subscription["tier"])

{
  "signals": [
    {
      "chain_name": "Starbucks",
      "signal_type": "BUY",
      "confidence": 0.82,
      "severity": "HIGH",
      "sentiment_current": 0.64,
      "sentiment_delta_7d": 0.08,
      "review_count_7d": 247,
      "created_at": "2026-04-03T08:05:00+00:00",
      "category": "Coffee",
      "sparkline_30d": [0.21, 0.24, 0.28]
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 25,
  "total_pages": 1
}