# SecondWing

> The product discovery platform for humans and AI. Find the right tools, compare your options, and help great products get seen.
> 100 published products across 97 categories. Every product is a structured entity with a stable id (SW-P-NNNNNN), a canonical URL and a machine endpoint.

## Data semantics

- Facts (pricing, features, platforms) carry a source and a verification date.
- Relationships (alternative, competitor, similar, complementary, integration) carry confidence, a reason and evidence.
- Signals (views, votes, saves) are community activity, not endorsements.
- Opinions are user reviews, moderated before publication.
- AI-derived fields are labelled with model, generation date and confidence, and never overwrite facts.
- Promoted placements are labelled and never change organic ranking or search relevance.

## Machine endpoints (JSON, schema version 2026-09-01)

- http://localhost:3000/api/v1/products — list products (q, category, page, pageSize)
- http://localhost:3000/api/v1/products/SW-P-000001 — full product entity
- http://localhost:3000/api/v1/products/SW-P-000001/alternatives — alternatives with reasons
- http://localhost:3000/api/v1/products/SW-P-000001/relationships — typed relationship edges
- http://localhost:3000/api/v1/products/SW-P-000001/reviews — published reviews
- http://localhost:3000/api/v1/search?q=crm+for+a+10-person+startup+under+$50/month — intent search with parsed intent and why-it-fits
- http://localhost:3000/api/v1/compare?products=slug-a,slug-b — fact-only comparison
- http://localhost:3000/api/v1/trending — organic monthly rankings
- http://localhost:3000/api/v1/categories, http://localhost:3000/api/v1/use-cases — taxonomy

## Human pages

- http://localhost:3000/products — all products
- http://localhost:3000/categories/ai — AI
- http://localhost:3000/categories/design — Design
- http://localhost:3000/categories/development — Development
- http://localhost:3000/categories/marketing — Marketing
- http://localhost:3000/categories/sales — Sales
- http://localhost:3000/categories/productivity — Productivity
- http://localhost:3000/categories/finance — Finance
- http://localhost:3000/categories/customer-support — Customer Support
- http://localhost:3000/categories/hr — HR
- http://localhost:3000/categories/saas — SaaS
- http://localhost:3000/categories/education — Education
- http://localhost:3000/categories/health-fitness — Health & Fitness
- http://localhost:3000/trending — trending, with the ranking method documented on the page
- http://localhost:3000/developers — API documentation

## Usage

- Rate limit: 120 requests per minute per network address.
- Please send a descriptive User-Agent. Self-identifying crawlers are counted separately from human visits.
- Attribution: link back to the canonical product URL when citing SecondWing data.

## Notice

This deployment contains fictional demo listings for testing. Do not treat its product data as real-world information.