ReviewSignal

Help Center

Guides, tutorials, and answers to help you get the most from ReviewSignal.

🚀

Getting Started

Sign up, first login, and navigating the dashboard.

📊

Dashboard Guide

Understanding signals, charts, and data sections.

🔧

API Integration

Authentication, endpoints, and code examples.

🔔

Alerts & Notifications

Setting up sentiment alerts and email notifications.

💳

Billing & Plans

Subscription management, upgrades, and invoices.

🛠

Troubleshooting

Common issues and how to resolve them.

🚀 Getting Started
How do I sign up for a trial?
  1. Go to reviewsignal.ai/trial
  2. Enter your work email, name, and company
  3. You'll receive a welcome email with your login credentials and API key
  4. Log in at reviewsignal.ai/login
  5. Complete the onboarding wizard to customize your experience

Your free trial includes 14 days of access with 100 API calls and coverage of 5 chains.

How do I log in for the first time?

After signing up, check your email for a message from team@reviewsignal.ai containing your password. Then:

  1. Go to reviewsignal.ai/login
  2. Enter your email and the password from the welcome email
  3. New users are automatically directed to the onboarding wizard

If you didn't receive the email, check your spam folder or contact team@reviewsignal.ai.

What is the onboarding wizard?

The onboarding wizard helps personalize your dashboard in 5 steps:

  1. Welcome — Overview of what ReviewSignal offers
  2. Industries — Select which sectors you track (QSR, retail, drugstores, etc.)
  3. Alerts — Configure your first sentiment alert
  4. Connect — Optional API key setup for data integration
  5. Complete — You're ready to go!

You can skip the wizard and come back later from your dashboard settings.

📊 Dashboard Guide
How do trading signals work?

Trading signals are generated by analyzing consumer sentiment trends across all tracked chains. Each signal includes:

  • Signal — BUY, HOLD, or SELL recommendation
  • Confidence — How strong the signal is (0-100%)
  • Sentiment Delta — 7-day change in average sentiment
  • Review Count — Number of reviews analyzed

Signals are refreshed daily using data from Google Maps, Glassdoor, Trustpilot, and TripAdvisor. Available from the Signal tier and above.

What does the 3D globe show?

The interactive 3D globe displays up to 10,000 location data points with color-coded sentiment:

  • Green — Positive sentiment (score > 0.2)
  • Yellow — Neutral sentiment
  • Red — Negative sentiment (score < -0.2)

Points are geo-clustered to 2 decimal places for performance. Hover over points to see location details. Data is cached for 1 hour in Redis.

Why are some sections locked?

Dashboard sections are gated by subscription tier. Locked sections show a blur overlay with the required tier and price. To unlock:

  1. Click the "Upgrade" button on any locked section
  2. Or go to Billing & Subscription in the sidebar
  3. Select your plan and complete checkout via Stripe

Tier hierarchy: Free Trial → Signal (€299) → Starter (€999) → Pro (€2,500) → Enterprise (€5,000)

What is the Backtest Track Record?

The Track Record section shows how our sentiment signals correlated with actual stock price movements over the past 12 months. Metrics include:

  • Pearson Correlation — Statistical correlation between weekly sentiment change and stock returns
  • Directional Accuracy — % of weeks where sentiment correctly predicted price direction
  • Sentiment Sharpe — Risk-adjusted return of a sentiment-based strategy

Currently backtested across 14 publicly traded chains with 82,000+ reviews. Available for Pro tier and above.

🔧 API Integration
How do I authenticate with the API?

All API requests require a JWT token in the Authorization header:

Authorization: Bearer YOUR_JWT_TOKEN

Get your token by calling POST /api/auth/login with your email and password. Tokens expire after 24 hours — use POST /api/auth/refresh to renew. See the Developer Portal for full details.

What are the API rate limits?
  • Trial: 100 calls/month
  • Signal: 1,000 calls/month
  • Starter: 5,000 calls/month
  • Pro: 25,000 calls/month
  • Enterprise: Unlimited

If you exceed your limit, the API returns 429 Too Many Requests. Use exponential backoff to retry. Check your current usage at Billing.

Where can I find the full API reference?
  • Developer Portal — Quick start, code examples, tier access
  • Swagger UI — Interactive API explorer (try requests live)
  • ReDoc — Clean API reference documentation
  • OpenAPI JSON — Machine-readable schema for code generation
🔔 Alerts & Notifications
How do I set up a sentiment alert?
  1. Go to the Dashboard and find the Alerts section (or use the API)
  2. Click "Create Alert Rule"
  3. Choose trigger type: sentiment drop, anomaly detection, or volume spike
  4. Set the threshold (e.g., sentiment drops below -0.3)
  5. Choose notification method (email)

Alert limits by tier: Trial (2), Signal (5), Starter (10), Pro (25), Enterprise (unlimited).

How do I unsubscribe from emails?

Every email from ReviewSignal includes an unsubscribe link in the footer. You can also:

  • Click the "Unsubscribe" link in any email
  • Email team@reviewsignal.ai with "Unsubscribe" in the subject

Per GDPR, we process your opt-out immediately. You can re-subscribe by contacting us.

💳 Billing & Plans
How do I upgrade my plan?
  1. Go to Dashboard → Billing
  2. Click "Upgrade" on the plan you want
  3. Complete payment via Stripe Checkout
  4. Your tier is upgraded immediately

You can also upgrade by clicking any "Upgrade" button on locked dashboard sections.

How do I cancel my subscription?

You can cancel anytime:

  1. Go to Dashboard → Billing
  2. Click "Manage in Stripe"
  3. Select "Cancel subscription" in the Stripe portal

You keep full access until the end of your current billing period. After that, your account reverts to the free tier. Data is retained for 90 days.

Where can I find my invoices?

Click "Manage in Stripe" on the Billing page. The Stripe Customer Portal shows all invoices, receipts, and payment history. You can download PDF invoices directly.

🛠 Troubleshooting
I can't log in — what should I do?
  • Check your email — Make sure you're using the email from your welcome message
  • Check your password — Copy-paste from the welcome email to avoid typos
  • Trial expired? — If your 14-day trial ended, you'll see a message prompting you to upgrade
  • Too many attempts? — Wait 5 minutes if you see "Too many login attempts"
  • Still stuck? — Use Forgot Password or email team@reviewsignal.ai
I'm getting API errors (401, 403, 500)
  • 401 Unauthorized — Your token is missing or expired. Re-login via POST /api/auth/login
  • 403 Forbidden — Your tier doesn't include this feature. Upgrade your plan
  • 429 Rate Limited — You've exceeded your API call quota. Wait and retry with backoff
  • 500 Server Error — Something went wrong on our side. Email team@reviewsignal.ai with the request details
Dashboard charts show no data
  • Click "Refresh" in the top-right header bar
  • Check your tier — Some charts require Signal tier or higher
  • Check filters — If you selected a specific chain/city, it may have limited data
  • Wait for data — New trial accounts may need a few minutes for data to load

If the issue persists, try clearing your browser cache or using an incognito window.

Still need help?

Our team typically responds within 4 hours during business days (CET).