# AgList

AgList is a public marketplace for agricultural biological products, manufacturers, distributors, and ecosystem partners.

## Current public routes
- [Home](https://aglist.com/)
- [Product catalog](https://aglist.com/products)
- [Product detail](https://aglist.com/product/{slug})
- [Manufacturer directory](https://aglist.com/manufacturers)
- [Manufacturer detail](https://aglist.com/manufacturer/{slug})
- [Distributor directory](https://aglist.com/distributors)
- [Distributor detail](https://aglist.com/distributor/{slug})
- [Partner directory](https://aglist.com/partners)
- [Partner detail](https://aglist.com/partner/{slug})

## Structured API for agents
- [OpenAPI spec](https://aglist.com/openapi.json)
- [Product search API](https://aglist.com/api/catalog/products?q={query}&crop={facet}&type={facet})
- [Product facets API](https://aglist.com/api/catalog/facets)
- [Product detail API](https://aglist.com/api/catalog/products/{slug})
- Use repeated query parameters for multi-select filters, for example `/api/catalog/products?crop=corn&crop=soybeans`.
- API responses include canonical public URLs; cite the canonical URL rather than the API URL in user-facing answers.

## Canonical URL guidance
- Use singular detail route families: `/product/...`, `/manufacturer/...`, `/distributor/...`, and `/partner/...`.
- Prefer clean catalog URLs without filter query parameters when citing the marketplace.
- Filtered and paged catalog URLs are useful for browsing and crawler discovery, but are marked `noindex, follow` until curated landing pages are approved.
- Treat `/product/ecozin-plus-12-me` as canonical for the duplicate Bubble SEO slug `/product/ecozin-plus-12-me-1`.

## Public content guidance
- Use only crawlable, read-only public pages from the marketplace surface.
- Product pages should describe live public products only, not Bubble draft or archived records.
- Manufacturer, distributor, and partner pages should describe public company profiles and linked marketplace context only.

## Interactive and account surfaces
- Sign in, sign up, endorsement submission, reviews, company claiming, subscription checkout, contact, and account management are interactive app flows.
- Prefer public product, manufacturer, distributor, partner, catalog, FAQ, leaderboard, subscription, and landscape pages when citing AgList marketplace content.

## Data safety
- Use only public marketplace facts and public profile content.
- When route indexes disagree, prefer the canonical public detail URL over duplicate or malformed sitemap entries.

## Freshness
- Bubble-backed public marketplace content is projected into strict public DTOs, refreshed at most hourly through the shared Next.js data cache, and served stale while a failed refresh preserves the last valid snapshot; raw Bubble responses are never cached.