API Documentation

Public, read-only REST API for supplement safety data

All endpoints are free, require no authentication, and return JSON. CORS is enabled for all origins. Rate limiting is applied at the server level.

Structured Data Exports

URL	Format	Description
`/data.json`	JSON	Full dataset: all 393 ingredients, 100 labels, brand summaries, product metadata
`/llms.txt`	Text	LLM-optimized summary with endpoints, safety scale, and citation info
`/llms-full.txt`	Text	Complete dataset in LLM-readable format — all 393 ingredients with clinical pearls, all 100 labels

Search

GET https://supplement.ge/wp-json/sx/v1/search?q={query}

Searches across ingredients (by name and scientific name), labels, brands, and products. Returns up to 20 results.

Parameter	Type	Description
`q`	string	Search query (min 2 characters)

Example response:

[
  {"name": "Vitamin D", "type": "ingredient", "slug": "vitamin-d"},
  {"name": "NOW Foods", "type": "brand", "slug": "now-foods"}
]

Products by Ingredient

GET https://supplement.ge/wp-json/sx/v1/db/products-by-ingredient?group={name}

Returns US supplement products containing a specific ingredient. Queries 28,605 on-market products from the NIH DSLD database.

Parameter	Type	Default	Description
`group`	string	required	Ingredient group name (e.g., "Vitamin D", "Zinc")
`on_market`	int	1	Filter by on-market status (1 = on market, 0 = all)
`limit`	int	20	Results per page (max 100)

Brand Safety Scorecard

GET https://supplement.ge/wp-json/sx/v1/db/brand-scorecard?brand={name}

Returns a comprehensive safety scorecard for a supplement brand, including product count, ingredient safety distribution, product forms, and types. Aggregates data across all on-market products from the NIH DSLD.

Parameter	Type	Description
`brand`	string	Brand name (exact match, e.g., "NOW Foods", "Nature Made")

Response includes:

product_count — total on-market products
unique_ingredients — distinct ingredients used
safety_summary — counts: safe, caution, warn, unknown
top_ingredients — top 20 ingredients with safety level and product count
product_forms — capsule, tablet, liquid, etc. with counts
product_types — supplement categories with counts

Collections (Read-Only)

Endpoint	Description	Count
`GET /wp-json/sx/v1/ingredients`	All ingredient safety profiles	393
`GET /wp-json/sx/v1/labels`	Certification labels (basic)	100
`GET /wp-json/sx/v1/labels-extended`	Labels with full metadata (trust tier, auditing, scope)	100
`GET /wp-json/sx/v1/brands`	All evaluated brands	228
`GET /wp-json/sx/v1/stats`	Platform statistics	—

AI & SEO Discoverability

File	Purpose
`/robots.txt`	Crawler directives — GPTBot, ClaudeBot, PerplexityBot allowed with crawl-delay
`/sitemap.xml`	Sitemap index → ingredients, labels, brands (2,470), top products (1,000)
`/llms.txt`	LLM discovery file (llms.txt standard)
`/data.json`	Full structured JSON export

Database

SupplementIndex cross-references the NIH Dietary Supplement Label Database (DSLD) with expert-authored safety profiles.

Table	Description
`sx_dsld_products`	28,605 on-market US supplement products (name, brand, form, product type, DSLD ID)
`sx_product_ingredients`	Ingredient links per product (ingredient group, amount, unit, daily value)
`sx_gsrs_substances`	615 FDA/GSRS substance mappings (UNII, CAS, ATC codes, synonyms)

Citation

Pkhakadze G, editor. SupplementIndex [Internet]. Tbilisi: Public Health Institute of Georgia; 2026. Available from: https://supplement.ge/