amplitude-user-lookup

jongwony's avatarfrom jongwony

Amplitude user behavior queries

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 1, 2026
[Reporting]

When & Why to Use This Skill

The Amplitude User Lookup skill enables Claude to interact directly with the Amplitude REST API to retrieve detailed user behavior data and activity logs. By leveraging Device IDs or User IDs, it streamlines the process of fetching real-time product analytics, allowing teams to analyze individual user journeys, track event histories, and gain actionable insights into user engagement without leaving the chat interface. This integration is essential for data-driven decision-making and rapid behavioral analysis.

Use Cases

  • Customer Support Troubleshooting: Quickly look up a user's recent activity via their Device ID to identify the exact steps leading up to a reported technical issue or bug.
  • Product Management Insights: Analyze the event history of specific power users to understand successful feature adoption patterns and user flow optimizations.
  • Developer Data Validation: Verify that custom events and properties are being correctly tracked in Amplitude by querying the raw event stream for a test user ID.
  • Growth & Retention Analysis: Identify churn risks by searching for users with declining activity levels and reviewing their last performed actions.
nameamplitude-user-lookup
description|
contextfork

Amplitude User Lookup

Query Amplitude user data via REST API using Device ID or User ID.

Prerequisites

Set environment variables:

export AMPLITUDE_API_KEY="your-api-key"
export AMPLITUDE_SECRET_KEY="your-secret-key"
export AMPLITUDE_REGION="us"  # or "eu" for EU data residency

Get keys from: Amplitude Dashboard > Settings > Projects > General

Quick Start

1. Search User (Device ID -> Amplitude ID)

python scripts/user_search.py "DEVICE-ID-HERE"

2. Get User Activity

python scripts/user_activity.py AMPLITUDE_ID --limit 50

Combined Workflow

# Get Amplitude ID first
AMP_ID=$(python scripts/user_search.py "DEVICE-ID" --json | jq -r '.matches[0].amplitude_id')

# Then get activity
python scripts/user_activity.py $AMP_ID --limit 100

Script Options

Script Options
user_search.py --json for raw JSON output
user_activity.py --limit N, --offset N, --direction [latest|earliest], --json

Rate Limits

  • User Search/Activity: 360 requests/hour
  • Concurrent requests: 5 max

References