Machine layer
Every product is a structured entity with a stable identifier, a canonical URL and a JSON endpoint. No key required, no scraping needed — schema version 2026-09-01.
Ids like SW-P-000100 never change or get reused.
120 requests per minute per network address. Send a descriptive User-Agent.
Sources, verification dates and confidence travel with the data.
| Endpoint | What it returns | Query params |
|---|---|---|
GET /api/v1/products | Paginated product list. | q, category, page, pageSize |
GET /api/v1/products/{id} | Full product entity: identity, classification, features, pricing, relationships, verification, freshness, AI-derived fields. | — |
GET /api/v1/products/{id}/alternatives | Alternatives and competitors with reason, confidence and verification status. | — |
GET /api/v1/products/{id}/relationships | All typed edges for a product. | type |
GET /api/v1/products/{id}/reviews | Published reviews (opinions). | page |
GET /api/v1/search | Intent search. Returns the parsed intent plus grounded why-it-fits reasons. | q, category, price, team, feature, platform, page |
GET /api/v1/compare | Fact-only comparison of 2–4 products. No winner is computed. | products=slug-a,slug-b |
GET /api/v1/trending | Organic monthly rankings with movement. | period, limit |
GET /api/v1/categories | Category tree with product counts. | — |
Try it: /api/v1/products/SW-P-000100
The response separates five kinds of statement, so you never have to guess whether something is a fact or an opinion.
"starting_price_monthly": 15
Carries source and verification date.
"alternatives": [{ "id": "SW-P-000002", "confidence": 0.95 }]Typed edge with reason and evidence.
"signals": { "upvotes": 88 }Community activity, not an endorsement.
"reviews": { "count": 10 }Moderated user reviews.
"ai_derived": { "model": "…", "confidence": 0.7 }Labelled with model and date; never overwrites facts.
last_modified."promoted": true so you can exclude paid placement from rankings you build.GET /api/v1/use-cases | Use cases with product counts. | — |
© 2026 SecondWing. All rights reserved.
Discover · Build · Grow