API Keys & Projects

Each website you track is a project in BotSights. Each project has its own API key and dashboard.

Creating a Project

  1. Go to Account settings
  2. Under Projects & API Keys, enter a name and domain
  3. Click Add Project
  4. Your API key is generated automatically — copy it for your integration setup

API Key Security

  • Each API key is tied to a domain. Requests from other domains are rejected.
  • Keep your API key private. Don't commit it to public repositories.
  • If your key is compromised, delete the project and create a new one.

Domain Validation

When a request arrives at our API, we check if the request's origin matches the project's configured domain. This prevents:

  • Using one API key on multiple sites (bypassing project limits)
  • Unauthorized use of your API key by third parties

The domain check is flexible: www.yourdomain.com and yourdomain.com both match. Subdomains like blog.yourdomain.com also match the root domain.

Project Limits

The number of projects you can create depends on your plan:

PlanProjects
Free1
Pro3
Business10
EnterpriseUnlimited

Deleting a Project

In your account settings, click the delete icon next to a project. This permanently removes:

  • The project and its API key
  • All stored bot visit data for that project

This action cannot be undone.