---
title: AuspexIQ
emoji: "🔮"
colorFrom: indigo
colorTo: purple
sdk: docker
app_port: 8000
pinned: false
---

# AuspexIQ

Reads the signs before you launch. AuspexIQ is a live analysis service that tells
any calling agent whether a YouTube niche is worth entering — using the
YouTube Data API v3 at request time to find outlier videos, measure
saturation, and return a verdict: **ENTER / CROWDED / AVOID**.

No mock data, no cached opinions, no hallucinated stats. Every number in every
response comes from a live API call (or a short-TTL cache of a previous live
response). Priced per call.

## Endpoints

Per-call pricing on X Layer (OKX Agent Payments Protocol).
Calling without payment returns `HTTP 402` + `PAYMENT-REQUIRED`;
x402-capable agents pay and retry automatically:

- `GET https://pima5-auspexiq.hf.space/paid/scan_niche?query=...` — 0.1 USDT
- `GET https://pima5-auspexiq.hf.space/paid/channel_outliers?channel=...` — 0.1 USDT
- `GET https://pima5-auspexiq.hf.space/paid/video_context?video=...` — FREE
- `GET https://pima5-auspexiq.hf.space/paid/rising_channels?niche=...` — 0.25 USDT
- Health: `https://pima5-auspexiq.hf.space/healthz` (free)

Available on OKX.AI as Agent #9453.

## Tools

### `scan_niche`

Assess a niche keyword: who ranks, how concentrated it is, which videos are
outliers relative to their own channel's baseline, and whether a new channel
should enter.

| Input | Type | Default | Notes |
|---|---|---|---|
| `query` | string | required | niche keyword, 2–80 chars |
| `region_code` | string | `US` | ISO 3166-1 alpha-2 |
| `recency_days` | int | 365 | 30–1825; only videos in this window |
| `max_results` | int | 50 | 10–50 search results analyzed |

Returns `saturation_score` (0–100), `verdict` (`ENTER` / `CROWDED` / `AVOID`)
with number-citing reasons, signals (channel diversity, top-3 view
concentration, 90-day freshness, small-channel breakouts), and up to 15
outlier videos — each with a watchable URL, its channel's baseline, and the
outlier multiple.

### `channel_outliers`

Reveal which of a channel's recent videos overperformed the channel's own
baseline (median views of recent long-form uploads).

| Input | Type | Default | Notes |
|---|---|---|---|
| `channel` | string | required | `UC...` ID, `@handle`, or channel URL |
| `lookback_videos` | int | 30 | 10–100 recent uploads |
| `min_multiple` | float | 2.5 | 1.5–10, views/baseline threshold |

## Error model

Failures return a structured error, never a fabricated result:

```json
{"ok": false, "error": {"code": "MISSING_API_KEY | QUOTA_EXHAUSTED | YT_API_ERROR | CHANNEL_NOT_FOUND | INVALID_INPUT | UPSTREAM_TIMEOUT", "message": "...", "retryable": true}}
```

Every response's `meta` reports cache state, fetch time, and quota units
spent/remaining for the day.