# ListIt — Comprehensive Documentation & Knowledge Base

> ListIt (https://listit-app.com/) is a free, mobile-first AI eBay listing assistant for iOS and Android. It turns photos into professional, ready-to-post eBay listings in seconds using Google Gemini AI, featuring zero subscription fees, live sold comp lookups, and direct device-to-API privacy.

---

## Table of Contents
1. [Overview & Philosophy](#overview--philosophy)
2. [How It Works](#how-it-works)
3. [Key Features](#key-features)
4. [Research Mode & Sourcing](#research-mode--sourcing)
5. [Monetization & Transparency](#monetization--transparency)
6. [Competitive Comparison](#competitive-comparison)
7. [Product Roadmap](#product-roadmap)
8. [Creator & Story](#creator--story)
9. [Technical Architecture & Security](#technical-architecture--security)
10. [Official Links & Downloads](#official-links--downloads)

---

## 1. Overview & Philosophy
ListIt was created by Andrew Baerga to eliminate the tedious manual labor of reselling on eBay. Traditional eBay listing requires 10 to 15 minutes per item to take photos, search for model numbers, draft condition notes, pick categories, and fill out dozens of eBay item specifics.

ListIt automates this entire process: users take 1 to 10 photos of any item, and Google Gemini AI analyzes the images to generate an optimized title (up to 80 characters), price recommendation with reasoning, condition notes, HTML item description, category, and item specifics. The seller reviews and edits the draft before publishing directly to eBay via official eBay OAuth 2.0.

### The Anti-Subscription Stance
Most competitor software (such as Vendoo, List Perfectly, and SellRaze) charges $15 to $50/month subscriptions or sells expiring 30-day token packs. ListIt rejects monthly paywalls for core listing. The app runs on a Bring-Your-Own-Key (BYOK) model where users connect their free Google Gemini API key with zero middleman markups, supported by minimal, non-intrusive ads.

---

## 2. How It Works
1. **Snap Photos:** Take 1 to 10 photos of the item from different angles (labels, barcodes, condition flaws).
2. **AI Analysis:** Google Gemini identifies the brand, model, condition, and market attributes in under 10 seconds.
3. **Review Draft:** Review and edit auto-filled eBay fields (Title, Price, Condition, Category, Item Specifics, Shipping format).
4. **Publish to eBay:** Tap "List It Now" to send the listing directly to your eBay store via official eBay APIs.

---

## 3. Key Features
- **Photo-to-Listing AI Drafting:** Instant multimodal product recognition and complete draft generation.
- **Human-in-the-Loop:** Complete user review and approval before anything is published.
- **Inventory & Live Listing Management:** View active listings, edit live details, and track performance.
- **Theme Personalization:** 11+ handcrafted themes (Tokyo Night, Catppuccin Mocha/Latte, Dracula, Monokai, One Dark/Light, Solarized Dark/Light).
- **Zero Intermediary Database:** API keys and listing drafts remain on the user's device.

---

## 4. Research Mode & Sourcing
Introduced in v1.4.0, Research Mode turns ListIt into a handheld sourcing assistant for thrift stores, garage sales, and flea markets:
- Snap a single photo of an unfamiliar item in the field.
- Gemini instantly identifies the item and provides an estimated resale valuation range.
- Access 1-tap live eBay sold comps directly from the screen.
- Save scans in the Research tab and convert any scan into a full eBay listing draft with one tap.

---

## 5. Monetization & Transparency
- **Core App (100% Free Forever):** Unlimited photo-to-listing and Research Mode using a free Google Gemini API key, supported by lightweight ads.
- **Optional Pro Upgrade (Monthly or Annual):** Removes all ads for maximum listing speed, unlocks all custom color themes, and provides advanced model integrations.
- **Planned White-Glove Token Bundles (1-Year Allotment):** For sellers who prefer not to set up API keys, pre-paid credit bundles that last a full 365 days rather than expiring after 30 days.

---

## 6. Competitive Comparison

| Feature / App | ListIt | Vendoo | List Perfectly | SellRaze |
| :--- | :--- | :--- | :--- | :--- |
| **Pricing** | $0.00 / mo (Free) | $14.99–$59.99/mo | $29.00–$69.00/mo | $23.99/mo ($199/yr) |
| **Mobile App** | Native iOS & Android | Mobile app available | No native mobile app | Mobile app available |
| **AI Listing** | Included (Free BYOK) | Add-on fee | Add-on fee | Included in sub |
| **Expiry Policy** | No expiring credits | Monthly reset | Monthly reset | Monthly reset |
| **Direct API Privacy** | Yes (Direct device to AI) | Server intermediary | Extension based | Server intermediary |

---

## 7. Product Roadmap
- **Multi-Model BYOK:** Expanding BYOK to support Anthropic Claude (Opus & Sonnet) and OpenAI ChatGPT.
- **Desktop Chrome Extension:** Companion browser extension for desktop comp research and listing drafting.
- **Batch "Death Pile" Mode:** Continuous photo capture and queued background drafting for processing high-volume inventory.
- **Community-Driven Cross-Listing:** Focused 100% on eBay listing perfection; cross-listing considered only upon widespread community request.

---

## 8. Creator & Story
Andrew Baerga built ListIt out of personal frustration while sorting boxes of garage items to list on eBay. Realizing that Google offers free Gemini API keys, he used AI tools and vibe coding to build a complete, transparent mobile solution inspired by classic foundational free software like WinZip and Winamp.

- **Creator:** Andrew Baerga
- **LinkedIn:** https://www.linkedin.com/in/andrewbaerga/

---

## 9. Technical Architecture & Security
- **Frontend / Mobile Framework:** Native Capacitor (iOS Swift / Android Kotlin)
- **AI Integration:** Direct device-to-endpoint Google Gemini API
- **eBay Integration:** Official eBay REST APIs (Inventory API, Trading API via OAuth 2.0)
- **Security:** Zero storage of eBay passwords; credentials handled exclusively through eBay OAuth.

---

## 10. Official Links & Downloads
- **Website:** https://listit-app.com/
- **About Us:** https://listit-app.com/about
- **Changelog:** https://listit-app.com/changelog
- **Blog Hub:** https://listit-app.com/blog/
- **Comparison Guide:** https://listit-app.com/blog/free-ai-listing-app-vs-paid-reseller-software
- **Roadmap Report:** https://listit-app.com/blog/future-plans-transparency-freemium-roadmap
- **iOS App Store:** https://apps.apple.com/us/app/listit-ebay-ai-listing-tool/id6792247400
- **Google Play:** https://play.google.com/store/apps/details?id=com.listitapp.app
- **Privacy Policy:** https://listit-app.com/privacy
- **Support Contact:** listit.support@gmail.com