SDK

Programmatically access and search your Raindrop data. Build dashboards, create eval sets, export data, or integrate Raindrop into your workflows.

Installation

npm install @raindrop-ai/query

pip install raindrop-query

Quick Start

import { RaindropQuery } from "@raindrop-ai/query";

const client = new RaindropQuery({
  apiKey: process.env.RAINDROP_QUERY_API_KEY,
});

// Search user inputs and assistant outputs for a phrase
const results = await client.events.search({
  query: "load times",
  mode: "text",
  searchIn: "user_input,assistant_output",
});

import os
from raindrop_query import RaindropQuery

client = RaindropQuery(api_key=os.environ["RAINDROP_QUERY_API_KEY"])

# Search user inputs for a phrase
results = client.events.search(
    query="load times",
    mode="text",
    search_in="user_input"
)

Get a Query API key at app.raindrop.ai under Settings → API Keys → Create personal key. This key is different from the write key used for ingestion. A personal key belongs to you and follows your role in the organization. Owners and admins can also create org-wide keys there for CI and servers. When an owner or admin turns on Limit to owners and admins on the same page, the Query SDK and MCP accept only owners’ and admins’ keys. Org-wide keys, including those in CI, get a 403, and members can no longer create keys.

Reads are scoped to a single project by default. Requests resolve to your org’s Production project (slug default), so single-project orgs need nothing extra. To target another project, send its slug in the X-Raindrop-Project-Id header. On supported read endpoints, pass * — the All projects view — to read across all active projects. You can narrow that view with project_ids. Endpoints without all-projects support reject * with a 400. See the Query API reference.

Common Patterns

List Signals

const response = await client.signals.list({ limit: 10 });

// Returns: { data: [...], meta: { cursor, has_more } }
const signals = response.data;

Get Events for a Signal

const signal = signals[0];

// Get count
const count = await client.events.count({ signal: signal.id });

// Get the actual events
const events = await client.events.list({
  signal: signal.id,
  limit: 100,
});

Event Counts Over Time

const timeseries = await client.events.timeseries({
  signal: signal.id,
  timestamp: { gte: new Date(Date.now() - 7 * 24 * 60 * 60 * 1000).toISOString() },
  interval: "day",
});

Error Handling

import { RaindropQuery } from "@raindrop-ai/query";
import { SDKValidationError } from "@raindrop-ai/query/models/errors";

try {
  const events = await client.events.list();
} catch (error) {
  if (error instanceof SDKValidationError) {
    console.error("Invalid request:", error.message);
  }
}

Getting Started

Integrations

Platform

Organization

Cookbooks

Workshop

Query API

MCP

Security

Support

SDK

Installation

Quick Start

Common Patterns

List Signals

Get Events for a Signal

Event Counts Over Time

Error Handling

​Installation

​Quick Start

​Common Patterns

​List Signals

​Get Events for a Signal

​Event Counts Over Time

​Error Handling

Installation

Quick Start

Common Patterns

List Signals

Get Events for a Signal

Event Counts Over Time

Error Handling