# GapScout.ai

GapScout is an API for structured customer gap intelligence — unmet needs extracted
from public reviews, surfaced in JTBD format for AI agent consumption.

## API Base URL
https://gapscout.ai/api/v1

## Auth
Header: x-api-key: YOUR_KEY
Get key: https://gapscout.ai/dashboard/api-keys (free tier available)

## Key Endpoints

GET /api/v1/gaps?product={slug}&format=jtbd
→ JTBD-formatted unmet needs for a product

GET /api/v1/gaps/search?q={natural language query}
→ Semantic search across all gaps (pgvector + FTS hybrid)

GET /api/v1/features?product={slug}&compare_to={slug,slug}
→ Feature comparison matrix across competitors

GET /api/v1/categories
→ All available product categories with gap counts

GET /api/v1/stream?product={slug}
→ Streaming GPT-4o analysis of gaps (SSE)

GET /api/v1/sources
→ Data pipeline health and freshness info

## Response convention
All responses include schema_version, data, meta, and agent_hints objects.
agent_hints contains suggested_next for navigation and api_docs link.

## Data freshness
Reviews refreshed every 6 hours via automated crawling.
Feature matrices updated weekly.
Trend velocity scored daily.

## Data sources
Primary: G2, Capterra, Trustpilot (JS-rendered via OpenCrawl)
Secondary: Reddit API, iTunes RSS, Hacker News Algolia, Product Hunt

## Full docs
https://gapscout.ai/api-docs

## OpenAPI spec
https://gapscout.ai/openapi.json