Architecture & Setup

Sentor is a fully managed, cloud-based sentiment analysis platform. It is not possible to run the Sentor server, ML engine, or Dashboard locally at the moment. Our infrastructure is hosted securely in the cloud to ensure high availability, scalability, and consistent performance for our machine learning models.

This guide explains how you can interact with the Sentor platform and set up your environment for integration.

🏗️ Platform Architecture

The Sentor platform consists of three main ways to interact with our services:

1. The Sentor Dashboard

The primary way to interact with Sentor is through our web-based Dashboard. The Dashboard provides a complete user interface for:

Managing projects and text data
Viewing entity-based sentiment analysis reports
Managing your subscription and billing
Generating API keys for programmatic access

2. Official SDKs (Recommended)

For developers looking to integrate Sentor into their applications, we highly recommend using our official SDKs. They provide a seamless, strongly-typed interface to our API without needing to manage HTTP requests manually.

Python SDK: Ideal for data science workflows, backend integrations, and ML pipelines.
JavaScript/TypeScript SDK: Perfect for Node.js backends or frontend applications.

Check out the SDK Installation Guides for more details.

3. Public API

Our backend API is primarily designed to power the Sentor Dashboard. However, we have opened up specific endpoints (such as the /predicts endpoint) for public developer use.

By passing your API key in the x-api-key header, you can make HTTP requests directly to our services from any language or framework.

🚀 Setup Guide

Since you don’t need to deploy anything locally, setting up Sentor is fast and straightforward.

Step 1: Create an Account

If you haven’t already, sign up for an account at dashboard.sentor.app.

Step 2: Generate an API Key

To use the SDKs or the public API, you need an API key:

Log in to the Dashboard.
Navigate to Settings > API Access.
Generate a new API key.
Keep this key secure. Do not share it or commit it to public repositories.

Step 3: Choose Your Integration Path

Decide how you want to connect to Sentor:

Using SDKs (Recommended): Best for most applications. See Code Examples.
Direct API Calls: Use standard HTTP clients (like curl, Axios, or requests). See the API Reference.
No-Code/Low-Code: Integrate Sentor into platforms like n8n or Zapier using our HTTP endpoints.

🔒 Security and Environments

When integrating Sentor, remember:

All API requests must be made over HTTPS.
Authenticate using the x-api-key header.
The sentor.app domain is our production environment, which you should use for all live integrations.

If you have any questions about integrating Sentor into your architecture, feel free to reach out to our Support team.