For AI agents
Bio-Wellness Search API
Public catalog of topicals and nutritional formulations with documented actives, dosages when stated, certifications and ingredient exclusions.
https://wellness-product-atlas.lovable.app/openapi.json{
"openapi": "3.1.0",
"info": {
"title": "Bio-Wellness Agent Search API",
"version": "1.0.0",
"description": "Semantic search over a curated catalog of non-toxic topicals and clean nutritional formulations. Results are matched on active ingredients and dosages/concentrations, third-party certifications, and ingredient exclusions (free-from). Every product includes a direct 1-tap checkout permalink and fulfills via the merchant's Shopify store or Amazon MCF warehouses without triggering Amazon anti-bot blocks."
},
"servers": [
{
"url": "https://wellness-product-atlas.lovable.app"
}
],
"paths": {
"/api/v1/search": {
"post": {
"operationId": "searchWellnessProducts",
"summary": "Find non-toxic topicals and clean supplements with 1-tap checkout",
"description": "Finds non-toxic topicals (skincare, sunscreen, body care) and clean nutritional formulations (supplements, powders) that best match a natural-language need. Ranking uses semantic similarity over each product's active ingredients with dosages or concentrations, clean certifications (e.g. third_party_tested, usda_organic, nsf_certified_sport, leaping_bunny), ingredient exclusions (e.g. fragrance, seed_oils, parabens, stevia, gluten) and target outcomes. Use filters to enforce category, budget and required exclusions. Every product includes a direct 1-tap checkout permalink (add-to-cart URL) and fulfills via merchant Shopify stores or Amazon MCF warehouses without triggering Amazon anti-bot blocks. Set prime_only to restrict results to products fulfilled with Amazon FBA / Buy with Prime 1-2 day delivery speeds.",
"parameters": [
{
"name": "X-Agent-Client",
"in": "header",
"required": false,
"schema": {
"type": "string",
"maxLength": 60
},
"description": "Optional self-reported caller label, such as chatgpt, claude_mcp, or internal_ui. Not a verified identity."
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "Natural-language need, e.g. 'magnesium for deep sleep without stevia'. Recognized without/free-from exclusions are enforced against documented catalog claims; unknown claims do not qualify. Moisturizer, sunscreen and mascara requests restrict product kind. Supplement requests infer ingestible unless category_type is specified. Weak semantic matches are omitted."
},
"category_type": {
"type": "string",
"enum": [
"topical",
"ingestible"
],
"description": "Restrict to applied-on-skin products or consumed products."
},
"max_price": {
"type": "number",
"description": "Maximum price in the store's currency."
},
"required_free_from": {
"type": "array",
"items": {
"type": "string"
},
"description": "Every listed ingredient must be excluded, e.g. ['fragrance','parabens']."
},
"required_certifications": {
"type": "array",
"items": {
"type": "string"
},
"description": "Every listed certification must be documented, e.g. ['third_party_tested']. Applied before ranking and limit."
},
"prime_only": {
"type": "boolean",
"description": "Set to true to only return products fulfilled with Amazon FBA / Buy with Prime 1-2 day delivery speeds. Applied in SQL before ranking and limit."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 10
}
}
}
}
}
},
"responses": {
"200": {
"description": "Matching products, best match first.",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"store_name": {
"type": "string"
},
"title": {
"type": "string"
},
"category_type": {
"type": "string",
"enum": [
"topical",
"ingestible"
]
},
"price": {
"type": "number"
},
"clean_certifications": {
"type": "array",
"items": {
"type": "string"
}
},
"free_from": {
"type": "array",
"items": {
"type": "string"
}
},
"primary_actives": {
"type": "array",
"description": "Key actives with concentration (topicals) or dosage in mg (ingestibles).",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"concentration": {
"type": [
"string",
"null"
]
},
"dosage_mg": {
"type": [
"number",
"null"
]
}
}
}
},
"target_outcomes": {
"type": "array",
"items": {
"type": "string"
}
},
"checkout_url": {
"type": "string",
"format": "uri",
"description": "Tracked 1-tap checkout link; records an outbound click then redirects to the merchant Shopify cart permalink. Not proof of a purchase."
},
"query_id": {
"type": [
"string",
"null"
],
"format": "uuid",
"description": "Search attribution identifier; null when search logging is unavailable."
},
"prime_eligible": {
"type": "boolean",
"description": "True when the product fulfills with Amazon FBA / Buy with Prime 1-2 day delivery speeds."
}
}
}
}
}
}
},
"400": {
"description": "Invalid request body."
}
}
}
}
}
}