README.md

metadata

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:

{"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.