For AI agents and developers

Formats, endpoints, field definitions and attribute schemas for AI assistants and developers using AgenticRecs data.

Everything on AgenticRecs is available as plain files. There is no login and no paywall, every page reads fine without JavaScript, and robots.txt allows AI search crawlers and agents.

Where to start

Read llms.txt for a map of guides, departments and categories.
Fetch catalog.json for every department, category, guide, brand and product, with the address of each one's full record.
Fetch a category's index.json to compare every product in it on the same fields, or a product's index.json for its full brief.

Formats

Any page as Markdown: add index.md to the page address. Product briefs start with YAML front matter that holds the structured fields.
JSON: product, category and guide pages also have index.json at the same address.
catalog.json: the manifest. It lists every department and category with product counts and price ranges, every guide and brand, and a compact record for every product that links to its full JSON.
llms.txt: a map for language models. It lists guides, departments and categories rather than every product, so it stays small as the library grows.
Department files: each department has one llms-full.txt with all of its guide and category pages as Markdown, for example running/llms-full.txt.
sitemap.xml: every HTML page with its last-modified date.
search-index.json: the compact index the site search uses.
HTML pages carry schema.org JSON-LD (Product, ItemList, Article, CollectionPage, BreadcrumbList).

Addresses

Product briefs live at /products/{id}/ and keep that address even if a product moves to another category.
Departments live at /{department}/ and categories at /{department}/{category}/. Long categories continue at /{department}/{category}/page/2/, but the category's index.json always lists every product.
Guides live at /guides/{guide}/, with chapters at /guides/{guide}/{chapter}/. Brands live at /brands/{brand}/.

Product fields

msrp_usd: the brand's full US list price on price_checked. Retailer prices vary.
price_tier: Budget, Mid-range or Premium, relative to the median list price in the product's category.
attributes: the category's own fields. Their meaning depends on the category's schema, listed below; each category's index.json repeats its schema with every value's definition.
awards: the picks a product holds, each with the guide and chapter that awarded it.
sources: the published reviews behind each verdict, each with a one-line summary of what it says.
evidence.tested_by_site: false until we test a product ourselves.
last_verified: the date we last checked the product's facts.

Attribute schemas

Running apparel (`running-apparel`)

Clothing and accessories for running. Ranges and scales assume steady running, not standing around. Used by Running base layers & tops, Running jackets, Running tights & pants, Running gloves & mittens, Running hats, headbands & gaiters, Running socks.

fits (Fits): a list of men (Men's), women (Women's), unisex (Unisex).
warmth (Warmth): one of light (Light), mid (Midweight), thermal (Thermal), insulated (Insulated).
wind (Wind): one of none (None), panels (Wind panels), full (Windproof).
water (Water): one of none (None), dwr (Water-resistant (DWR)), waterproof (Waterproof).
visibility (Visibility): one of none (None), reflective-details (Reflective details), high-vis (High visibility).
temp_range_f and temp_range_c (Temperature range): [low, high] in °F and °C. The temperatures a product suits as the main piece of its kind, for steady running. temp_basis says where the range comes from: brand, reviewer, estimate.

Buying links

Each entry in where_to_buy has a retailer, a full url and an affiliate flag. Paid links are also marked "(paid link)" on our pages and carry rel="sponsored". Amazon links use the standard amazon.com/dp/ASIN form. A link appears only after we've checked that it points to the right product.

Freshness

Last full update: Oct 26, 2026. Each product shows the date its facts were checked, and sitemap.xml gives every page's last-modified date.

Reuse

You may quote and summarize this content with a link to the source page.