# Piko

> Piko (pikosabe.com) is a horizontal marketplace (plataforma de intercambio) for Paraguay. It connects people who need with people who offer, across 6 listing types: services (servicios), goods (productos), properties (inmuebles), vehicles (vehículos), rentals (alquileres), and pets (mascotas). AI-powered natural language search and direct WhatsApp contact. Tagline: "Encontrá lo que necesitás. Publicá lo que ofrecés."

Piko targets entrepreneurial Paraguayans who hustle in the informal economy: freelancers, artisans, informal professionals, small business owners (25–55). The name *Piko* is the Guarani interrogative particle (used to ask "what / which?", e.g. "¿Piko necesitás?"), and a wink to the toucan's *pico* (beak) — the mascot is a toucan, the neighbor who knows everyone in the barrio and passes the dato. The platform positions itself as a permanent storefront replacing scattered WhatsApp lists. Users can publish listings for free, search using natural language (powered by AI embeddings), and contact providers directly via WhatsApp. The platform is available as a web app and native mobile app (iOS/Android via Capacitor).

## Content Types

- **Servicios (Services):** Home repair, beauty, education, events, legal, tech support, healthcare, security, cooking, and more
- **Productos (Goods):** Physical items for sale
- **Inmuebles (Properties):** Real estate listings — houses, apartments, land
- **Vehículos (Vehicles):** Cars, motorcycles, trucks
- **Alquileres (Rentals):** Items or spaces available for rent
- **Mascotas (Pets):** Pet adoption, sales, and services

## Public Pages

- [Inicio (Home)](https://pikosabe.com/): Main landing page with AI search and category browsing; `/?explorar=1` or `/?q={query}` opens the browse/results view (all listings, filters)
- [Acerca (About)](https://pikosabe.com/acerca): About Piko — mission, team, and vision
- [Piko Pro (Pricing)](https://pikosabe.com/pro): Freemium plans and subscription details
- [Contacto (Contact)](https://pikosabe.com/contacto): Contact form
- [Privacidad (Privacy)](https://pikosabe.com/privacidad): Privacy policy
- [Terminos (Terms)](https://pikosabe.com/terminos): Terms of service
- [Chat (AI Assistant)](https://pikosabe.com/chat): Conversational AI assistant for finding services and listings

## Dynamic Content

- [Listing detail](https://pikosabe.com/anuncios/{id}): Individual listing pages with description, images, pricing, and contact
- [User profile](https://pikosabe.com/@{nickname}): Public profiles with listings, reviews, and location (canonical form; `/u/{id}` and `/perfil/{id}` also resolve)

## Public API

- `GET /api/search?q={query}`: AI-powered natural language search across all listing types
- `GET /api/listings/active`: Active listings feed
- `GET /api/listings/relevant`: Location-based relevant listings
- `GET /api/listings/{id}`: Single listing detail
- `GET /api/users/{id_or_nickname}/profile`: Public user profile data (accepts UUID or nickname)

## Key Features

- Natural language search powered by AI embeddings (pgvector + Google Gemini)
- WhatsApp-based authentication (OTP via WhatsApp)
- Direct WhatsApp contact with providers (server-mediated, phone numbers never exposed)
- AI assistant for conversational search and recommendations
- Voice-to-text input for search queries
- Boost system for promoted listings
- Review and rating system
- Push notifications (FCM)
- Referral program
- Freemium subscription model via Pagopar (Paraguay) and Apple IAP (iOS)

## Technical

- Built with Nuxt 4, Nuxt UI v4, Tailwind CSS
- Backend: Nitro server on Cloudflare Workers
- Database: Supabase (PostgreSQL + Auth + Storage)
- Mobile: Capacitor (iOS/Android)
- Language: Spanish (es_PY locale), UI and content in Paraguayan Spanish
- Canonical URLs use Spanish aliases (e.g., /acerca not /about)

## Sitemap

- [Sitemap](https://pikosabe.com/sitemap.xml): Full XML sitemap with all public pages, listings, and user profiles