Rare Agents Data API
Programmatic access to AI intent signals, consumer behavior feeds, and digital lifestyle intelligence. All data is opt-in, GDPR/CCPA compliant, and blockchain-anchored.
Overview
The Rare Agents Data API provides corporate buyers with programmatic access to the Data Exchange. All endpoints use HTTPS and return JSON by default. CSV output is available on download endpoints via the ?format=csv query parameter.
Base URL
https://rareagents.ai
Response Format
JSON (CSV optional)
Latency (p99)
< 200ms
Authentication
All API requests require a Bearer token in the Authorization header. Your API key is issued after purchasing a dataset subscription from the Corporate Plans page.
Keep your API key secret. Never expose it in client-side code. Rotate keys from your account dashboard.
# All requests must include this header Authorization: Bearer ra_live_sk_your_key_here
Endpoints
/api/corporate/datasets Auth requiredList all available dataset products with pricing and metadata.
Parameters
categorystring?Filter by category (ai_intent | consumer_behavior | digital_lifestyle)deliverystring?Filter by delivery method (api | download | both)Response
{
"datasets": [
{
"id": "ai-intent-v1",
"name": "AI Intent Dataset",
"price_monthly": 2000,
"update_frequency": "real_time",
"delivery_methods": ["api", "csv"],
"record_count_approx": 50000,
"compliance": ["gdpr", "ccpa", "opt_in"]
}
]
}/api/corporate/datasets/:id/sample Auth requiredDownload a 100-record sample for a specific dataset.
Parameters
formatstring?Response format: json (default) | csvResponse
{
"schema_version": "1.0",
"dataset": "ai_intent_signals",
"records": [
{
"record_id": "RAA00001",
"category": "ai_tools",
"ai_query": "best AI agent for email automation",
"intent_score": 0.847,
"topic_affinity": "high",
"region": "US",
"value_score": 76,
"pii_removed": true,
"consent_verified": true,
"timestamp_utc": "2026-04-15"
}
]
}/api/corporate/datasets/:id/subscribe Auth requiredCreate a subscription to a dataset product. Returns a Stripe Checkout Session URL.
Parameters
billing_emailstringBilling contact emaildelivery_methodstringapi | download | bothResponse
{
"checkout_url": "https://checkout.stripe.com/pay/cs_live_...",
"subscription_id": "sub_...",
"access_key": "ra_live_sk_..."
}/api/corporate/datasets/:id/stream Auth requiredStream real-time intent signals as NDJSON (AI Intent Dataset only). Requires active subscription.
Parameters
categoriesstring?Comma-separated category filtermin_intent_scorefloat?Minimum intent_score threshold (0.0–1.0)regionstring?ISO country code filterResponse
{"record_id":"RAA10023","category":"ai_tools","intent_score":0.91,"region":"US","value_score":82,"timestamp_utc":"2026-06-16"}
{"record_id":"RAA10024","category":"automation","intent_score":0.74,"region":"GB","value_score":61,"timestamp_utc":"2026-06-16"}/api/corporate/usage Auth requiredRetrieve API usage for the current billing period.
Response
{
"period_start": "2026-06-01",
"period_end": "2026-06-30",
"requests_made": 1240,
"records_delivered": 62000,
"quota_requests": 50000,
"quota_records": 2000000,
"overage_usd": 0
}Field Reference
All datasets share this base schema. Consumer Behavior and Digital Lifestyle feeds include additional category-specific fields documented in your subscription welcome email.
| Field | Type | Description |
|---|---|---|
| record_id | string | Unique anonymised identifier (hex-encoded) |
| category | enum | ai_tools | small_business | automation | productivity | developer_tools | marketing | finance | healthcare | ecommerce | education |
| ai_query | string | Anonymised query or intent phrase |
| intent_score | float | AI-calculated intent likelihood (0.0 – 1.0) |
| topic_affinity | enum | high | medium | low |
| region | string | ISO 3166-1 alpha-2 country code |
| device_type | enum | desktop | mobile | tablet |
| session_depth | integer | Number of queries in the same intent session (1–10) |
| value_score | integer | RAPIDS monetisation value score (0–100) |
| pii_removed | boolean | PII scrubbing confirmed by RAPIDS pipeline |
| consent_verified | boolean | Explicit user consent verified before inclusion |
| blockchain_anchored | boolean | Provenance anchored on Solana Memo Program |
| timestamp_utc | date | Capture date (YYYY-MM-DD) |
Code Examples
cURL
curl -X GET "https://rareagents.ai/api/corporate/datasets" \ -H "Authorization: Bearer ra_live_sk_your_key_here" \ -H "Accept: application/json"
Python
import requests
BASE = "https://rareagents.ai/api/corporate"
HEADERS = {"Authorization": "Bearer ra_live_sk_your_key_here"}
# List datasets
r = requests.get(f"{BASE}/datasets", headers=HEADERS)
datasets = r.json()["datasets"]
# Stream AI intent signals
with requests.get(
f"{BASE}/datasets/ai-intent-v1/stream",
headers=HEADERS,
params={"min_intent_score": "0.7", "region": "US"},
stream=True
) as r:
for line in r.iter_lines():
if line:
record = json.loads(line)
print(record["intent_score"], record["ai_query"])Node.js
import fetch from "node-fetch";
const BASE = "https://rareagents.ai/api/corporate";
const KEY = "ra_live_sk_your_key_here";
const hdrs = { Authorization: `Bearer ${KEY}`, Accept: "application/json" };
// Fetch sample data
const res = await fetch(`${BASE}/datasets/ai-intent-v1/sample?format=json`, { headers: hdrs });
const { records } = await res.json();
console.log(`Received ${records.length} sample records`);
records.filter(r => r.intent_score > 0.8).forEach(r =>
console.log(r.record_id, r.ai_query, r.intent_score)
);Rate Limits & SLA
| Plan | Requests / min | Records / month | Uptime SLA |
|---|---|---|---|
| AI Intent ($2k/mo) | 60 | 2,000,000 | 99.5% |
| Consumer Behavior ($3.5k/mo) | 120 | 5,000,000 | 99.5% |
| Digital Lifestyle ($5k/mo) | 300 | 10,000,000 | 99.9% |
| Enterprise (custom) | Custom | Unlimited | 99.99% |