openrouter-analytics-query

Document constructing and executing analytics queries against the OpenRouter Analytics API.

209|33|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/OpenRouterTeam/skills --skill openrouter-analytics-query
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openrouter-analytics-query
Source: https://github.com/OpenRouterTeam/skills/tree/main/skills/openrouter-analytics-query
Command: npx skills add https://github.com/OpenRouterTeam/skills --skill openrouter-analytics-query

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Users building or debugging queries for the OpenRouter Analytics API often lack complete, up-to-date documentation for query parameters, request/response schemas, and error handling, leading to failed queries, incorrect data retrieval, and wasted development time.

Core Features & Use Cases

  • Complete Parameter Reference: Full documentation for all query fields including metrics, dimensions, filters, time ranges, ordering, and pagination limits.
  • Multi-Method Usage Guidance: Step-by-step instructions for executing queries via both the dedicated CLI script and direct cURL API calls.
  • Use Case Example: A data analyst can use this skill to pull request count and total usage metrics filtered to specific models over a 30-day period, then sort results by highest usage to identify top-performing models.

Quick Start

Use the openrouter-analytics-query skill to build a query that retrieves total usage and request count grouped by model for the last 7 days, ordered by total usage in descending order.

Frequently Asked Questions about openrouter-analytics-query

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build an OpenRouter analytics query to filter usage metrics by model?

To build an analytics query, you define metrics, dimensions, and time ranges, then apply filter syntax rules to narrow results to specific models. This skill provides the complete parameter reference needed to construct valid OpenRouter API requests for usage reporting.

Why does my OpenRouter API request fail when querying time series data?

API requests fail when parameters violate filter syntax rules, time range configurations, or pagination limits. This skill provides complete reference documentation for debugging failed requests, interpreting response structures, and resolving common OpenRouter analytics query errors.

What parameters are required for OpenRouter Analytics API integration?

Required parameters include target metrics, dimensions, and time range configurations. This skill covers all required and optional request fields, filter syntax, ordering parameters, and pagination controls needed to execute valid OpenRouter analytics queries.

Can I execute OpenRouter analytics queries using cURL?

Yes, you can execute queries using direct cURL API calls or a dedicated CLI script. This skill provides step-by-step instructions for both execution methods to retrieve metrics like request count and total usage grouped by model.

How do I interpret the response data structure from an OpenRouter metrics query?

Interpreting response data requires understanding the schema returned for your requested metrics and dimensions. This skill provides documentation for interpreting query response data structures and handling standard HTTP error codes during analytics integration.