# Suplementor

> Search, compare, and verify supplement formulations against clinical references. Evidence-based supplement intelligence for people and a payable structured data API for AI agents.

Suplementor is an evidence-based supplement intelligence platform. It serves two audiences:
people (biohackers, athletes, and health professionals) who search, compare, and verify
supplement formulations against clinical references, and AI agents that consume the same
structured data through a pay-per-call API using the x402 protocol (USDC on Base).

## For humans

- Marketing overview: https://suplementor.io/
- Features: https://suplementor.io/features
- Pricing: https://suplementor.io/pricing
- Methodology (how data is sourced, normalized, and verified): https://suplementor.io/methodology
- Product catalog: https://suplementor.io/products

## For AI agents

- Agent landing page: https://suplementor.io/agents
- OpenAPI 3.1 document: https://suplementor.io/api/v1/openapi.json
- x402 discovery (well-known): https://suplementor.io/.well-known/x402.json
- x402 discovery (API clients): https://suplementor.io/api/v1/x402/discovery

Start by fetching https://suplementor.io/.well-known/x402.json, then read https://suplementor.io/api/v1/openapi.json
for full schemas and route details.

## Payment model

Most agent endpoints are pay-per-call via the x402 protocol. Payment is settled in USDC on Base.
The usage-summary endpoint is free but still requires a valid wallet signature.
There are no API keys or contracts: an unpaid request returns HTTP 402 PAYMENT-REQUIRED with
x402 payment requirements and Bazaar discovery metadata; settle the micro-payment and retry
with an `X-PAYMENT` header to receive the response.
When rotating receiving addresses are enabled, discovery documents intentionally omit a fixed
`payTo`; use the live 402 challenge as the source of truth for the address to pay.

Read credits: Wallets with read-credits settle $0 for reads — a credited call returns no PAYMENT-RESPONSE header. Read-credits are earned on accepted submissions; the 402 challenge is anonymous, so check your balance at the usage endpoint. Balance endpoint (free, signed): https://suplementor.io/api/v1/x402/usage.
A credited call still authorizes a payment; it just isn't settled on-chain.

## Paid endpoints and pricing (USDC)

- GET  /api/v1/x402/products?q=...     Search the verified catalog.        $0.005 / call
- GET  /api/v1/x402/products/:id       Product detail + normalized list.   $0.01–$0.01 / call
- POST /api/v1/x402/submissions        Submit a new product.               $0.01 / call (price here for spam prevention; users earn 100 read credits for accepted submissions, see https://suplementor.io/pricing)

## Free authenticated endpoint

- POST /api/v1/x402/usage              Wallet usage summary (signed).      $0 / call

Absolute endpoint URLs:
- https://suplementor.io/api/v1/x402/products
- https://suplementor.io/api/v1/x402/products/:id
- https://suplementor.io/api/v1/x402/submissions
- https://suplementor.io/api/v1/x402/usage

## Submission contract

- `ingredients` is required and must contain at least one ingredient.
- Each ingredient must include `raw_name`, `raw_quantity`, and `raw_unit`.
- `raw_unit` must be one of: mcg, mg, g, kg, ml, l, IU.
- The submitting wallet is the x402 payer (taken from the `X-PAYMENT` authorization), and
  the payment nonce provides replay protection — no `wallet_address`, `signature`, or
  `nonce_timestamp` fields are required in the body. Required top-level fields:
  `name`, `official_product_url`, `ingredients`.
- New submissions enter the catalog as `pending` and are reviewed before publication.

## Usage summary contract

- Usage summaries are wallet-scoped and free, but require EIP-191 signature authentication.
- Required fields: `wallet_address`, `signature`, `nonce_timestamp`.
- Response includes: `searches_count`, `products_fetched_count`, `submitted_products`
  (with status for each), and `outstanding_credits` (0 when none).

## For brands

Supplement brands whose products appear in the catalog can claim listings, submit corrections,
and benchmark formulations. The Brand audience page and waitlist are at:

- For brands overview: https://suplementor.io/for-brands
- Brand pricing: https://suplementor.io/pricing#brand
- EU Health Claims Checker: https://suplementor.io/eu-health-claims-checker: check supplement claims against the EU Register under Regulation 1924/2006
- Supplement Label Compliance EU: https://suplementor.io/supplement-label-compliance-eu: EU and per-country rules for supplement labels, claims, and maximum levels
- Compliant Supplement Marketing: https://suplementor.io/compliant-supplement-marketing: write EU-compliant supplement copy that converts and survives ad review
- Competitor Analysis: https://suplementor.io/supplement-competitor-analysis: benchmark doses, forms, and price per serving against 200k+ normalized formulations
- Novel Food Compliance: https://suplementor.io/novel-food-compliance-eu: screen formulations against EU novel food status before launch
- Supplement Data API: https://suplementor.io/supplement-data-api: REST API for normalized supplement label data, x402 per-call or subscription
- Sport Compliance: https://suplementor.io/wada-compliant-supplements: screen formulations against WADA-prohibited substances and third-party certification status
- AI Agents & Brands: https://suplementor.io/ai-agents-supplement-brands: see what AI agents see about your supplement brand and correct it

## Notes

- Suplementor provides informational data about supplement formulations and is not medical advice.
- Discovery endpoints above are public and reachable without authentication or payment.