# Huntli — Full Documentation for AI Agents

> AI-powered shopping research assistant that helps users research, compare, and make informed purchasing decisions.

## Overview

Huntli is a conversational AI shopping assistant deployed at https://huntli.app. Users interact through a chat interface, describing what they're looking for in natural language. The system searches across thousands of retailers in real-time, retrieves actual product data, verifies prices and stock status, scores products using AI, and presents transparent recommendations.

Huntli is NOT a marketplace — it does not sell products directly. It is a research and comparison tool that helps users find the best options and then links them to the retailer's own website to complete their purchase.

## How It Works

1. **Ask**: Users describe what they need ("best wireless headphones under €200 for commuting")
2. **Discover**: Huntli searches the web, finding products across multiple retailers
3. **Verify**: Each vendor listing is checked — real prices, stock status, shipping availability
4. **Score**: AI analyzes and ranks products based on the user's priorities
5. **Decide**: Users compare options side-by-side and click through to buy from their chosen retailer

## Core Capabilities

### Product Discovery
- Natural language search (not keyword-based)
- Real-time web search across thousands of retailers
- Multi-region support across 15 regions: US, UK, DE, NL, FR, CA, AU, AT, CH, BE, ES, IT, SE, NO, DK
- Handles complex queries: "OLED TV for bright room, 55-65 inch, under €1500"

### Vendor Verification
- Scrapes actual product pages to confirm prices
- Checks stock availability in real-time
- Validates shipping to user's region
- Detects aggregators and marketplaces vs direct retailers

### AI Scoring & Comparison
- Products scored on relevance, value, vendor trust, and data quality
- Side-by-side comparison tables generated by AI
- Personalized recommendations based on user preferences
- Badges: "Top Pick", "Best Value", "Best Premium"

### Stash Management
- Save products to organized "Stashes" (shopping projects)
- Set budgets and constraints per stash
- Share stashes via read-only links
- Compare saved products across stashes

## Supported Regions

Huntli supports 15 regions with localized search, pricing, and vendor verification.

| Region | Coverage |
|--------|----------|
| Netherlands (NL) | Primary — deepest retailer coverage |
| Germany (DE) | Strong |
| United Kingdom (UK) | Strong |
| United States (US) | Strong |
| France (FR) | Moderate |
| Australia (AU) | Moderate |
| Canada (CA) | Moderate |
| Austria (AT) | Supported |
| Switzerland (CH) | Supported |
| Belgium (BE) | Supported |
| Spain (ES) | Supported |
| Italy (IT) | Supported |
| Sweden (SE) | Basic |
| Denmark (DK) | Basic |
| Norway (NO) | Basic |

## Technology

- Framework: Next.js (App Router, React 19)
- AI: Google Gemini (latest models)
- Database: Supabase (PostgreSQL)
- Search: Serper.dev + Oxylabs
- Scraping: Firecrawl + Oxylabs

## Pages

- [Home](https://huntli.app): Landing page with product demo
- [About](https://huntli.app/about): Brand story, mission, affiliate transparency disclosure
- [How It Works](https://huntli.app/how-it-works): Visual walkthrough of the product experience
- [FAQ](https://huntli.app/faq): Common questions about pricing, data, privacy
- [Pricing](https://huntli.app/pricing): Free to use
- [Privacy Policy](https://huntli.app/privacy): GDPR-compliant data practices
- [Terms of Service](https://huntli.app/terms): Usage terms and conditions

## Monetization

Huntli uses affiliate links. When a user clicks through to a retailer and purchases, Huntli may earn a commission. Affiliate partnerships NEVER influence product rankings or recommendations. All scoring is agnostic.

## Brand Disambiguation

**Huntli (huntli.app)** is an AI-powered consumer shopping assistant, launched in 2026 by Noumenic (Netherlands).

It is **NOT affiliated with** the Latvian B2B RegTech/FinTech company (huntli.io) founded in 2021 by Lev Bass, which provides transaction monitoring and AML compliance software for financial institutions.

## Contact

- Website: https://huntli.app
- Email: support@huntli.app
- X/Twitter: https://x.com/huntliapp
- Instagram: https://instagram.com/huntli.app
- Support: support@huntli.app