Skip to main content

​
Query API

The Query API is currently in beta. Contact support@raindrop.ai for access.
The Raindrop Query API lets you programmatically access events, signals, users, and conversations from your Raindrop account.

​
Base URL

​
Authentication

All API requests require a Bearer token. Get your API key from the Raindrop dashboard.
Use your Organization API Key for the Query API, not the Write Key you use for ingesting data. For security purposes, these keys are different and have separate permissions.

​
Projects

Reads are scoped to a single project. By default the Query API reads from your org’s Production project (slug default), so single-project orgs need nothing extra. If your org has multiple projects, target one by sending its slug in the X-Raindrop-Project-Id header:
Omitting the header (or sending default) reads from the Production project. An archived or unknown project is rejected with a 403, and a malformed slug with a 400.

​
Resources

Events

Query and search your event data

Signals

Access signal definitions and matches

Users

Get user profiles and activity

Conversations

Browse conversation threads

​
Pagination

All list endpoints support cursor-based pagination:
Pass the cursor value to fetch the next page:

​
Filtering

Most endpoints support filtering by timestamp and other fields:

​
Rate Limits

Rate limits per API key:
  • 400 RPM for most endpoints
  • 50 RPM for GET /v1/events/search
  • 40 RPS across all endpoints combined; a GET /v1/events/search request is rejected once combined usage reaches 20 RPS