Frequently Asked Questions

FAQ

Below are the canonical answers to the most-asked questions about how Hermetica's open ingredient encyclopedia is built, what you can do with it, and how it differs from the Hermetica product line. Each answer is also exposed as Schema.org FAQPage markup so AI engines and Google's rich-result surface can quote the answer directly.

What is the Hermetica Ingredient Encyclopedia?

An open supplement reference built from 16,246 ingredient source records. At the 2026-07-11 baseline, the public gate exposed 6,100 ingredient profiles. The separate 121,278 interaction count is raw source rows, not reviewed conclusions. Corpus size is not a Google indexing or human-review count.

Is the data evidence-based?

Each public profile discloses publication state, validation status, issue codes, and whether its score is validated or provisional. Citations appear where they passed the screening pipeline; a citation or public listing does not by itself mean the narrative was human-approved.

How do I check if two supplements interact?

Visit /interactions/{substance-a}/{substance-b} or use the per-substance hub at /interactions/{substance}. Public interaction pages expose only records that pass the reviewed-interaction gate. A classification label is not clinical clearance, and a missing record means unknown rather than safe; confirm the exact products with a qualified clinician or pharmacist.

What are the health-goal profile lists at /stacks?

The /stacks section contains 17 automated discovery lists for topics such as Sleep, Stress, Cognitive, Energy, Immune, and Gut Health. Each shows up to 12 publication-gated profiles ordered by provisional public score and condition-match signals. The lists are noindex while validation is incomplete and are not human-curated treatment, combination, or purchase recommendations.

Can I cite Hermetica data in my own work?

Yes. The dataset is CC BY-NC-SA 4.0 — you may share, adapt, and build on it for non-commercial use with attribution. Format: "Source: Hermetica Superfoods Ingredient Encyclopedia, https://ingredients.hermeticasuperfoods.com/ingredients/{slug}". Commercial licensing available — email admin@hermeticasuperfoods.com.

How often is the data updated?

Automated source, citation, and quality jobs run on different schedules, and each response exposes its available update timestamp. An automated refresh is not human review: claim-bearing edits invalidate prior approval and must pass the applicable gate again.

Do I need a Hermetica account to access the data?

No. The public encyclopedia, reviewed-only interaction endpoints, noindex derivative guides, and LLM digest are accessible without an account. The Hermetica product catalog is a separate commercial truth layer.

Is there an API?

Yes. Public REST API at /api/v1 with OpenAPI 3.1 spec at /api/v1/openapi.json. No authentication required for read access. Rate limits and bulk-export licenses available on request.

How do I cite ingredients for AI-generated content?

Use the LLM-optimized digest at /llms-full.txt (1.5 MB markdown digest of top 500 ingredients) for direct ingestion. The /llms.txt manifest tells AI crawlers where to find structured data.

What's the difference between this encyclopedia and Hermetica products?

The encyclopedia and the product catalog are separate truth layers. An ingredient profile does not prove that a Hermetica product contains that ingredient or supports the same claims; product links appear only when the current formula relationship is separately verified.

Can I trust the medical information?

All content is for educational purposes only and is not medical advice. Always consult a qualified healthcare professional before making supplement, medication, or health decisions. Our editorial policy at /editorial-policy details our review process.

How do I report an error or correction?

Email admin@hermeticasuperfoods.com or visit /corrections. We log every correction publicly with the original claim, the correction, and the source.