YOUTUBERS GAVE THESE HONEST REVIEWS. LEARN MORE.
GrailPeople
GrailPeople

Creator Beauty Intelligence API

Structured, creator-attributed beauty product data — indexed from hundreds of YouTube Shorts.

FreeNo auth requiredCORS enabledgrailpeople.com →
215Creators indexed
9929Products enriched
15006Creator mentions

API Endpoints

GET/api/v1/recommendations

Product recommendations ranked by endorsement strength. Returns creator quotes, signal counts, consensus summaries, caveats, price, and retailers. The primary discovery endpoint.

Params: q, subcategory, ingredient, concern, endorsed_only, max_price_usd, creator_type, price_tier, skin_type, skin_tone, verified, origin, look, attribute, routine_context, preference, value, creator, limit
curl "https://grailpeople.com/api/v1/recommendations?subcategory=spf&endorsed_only=true&max_price_usd=40"
GET/api/v1/products/[slug]

Full creator evidence dossier for one product. All creator quotes with timestamps, sponsorship disclosure, signal counts, tags, endorsement strengths, caveats, and retailers. Merges shade variants.

Params: slug
curl "https://grailpeople.com/api/v1/products/aestura-atobarrier365-cream"
GET/api/v1/brands/[slug]

Full brand detail: AI-generated verdict, signature products, creator list, and all brand products with endorsement signals.

Params: slug
curl "https://grailpeople.com/api/v1/brands/aestura"
GET/api/v1/creators/[handle]

One creator's full product history with quality-gated mentions, quotes, endorsement strengths, specialty, and years active.

Params: handle, endorsed_only, subcategory
curl "https://grailpeople.com/api/v1/creators/drdrayzday?endorsed_only=true"
GET/api/v1/products

All enriched canonical products with quality-gated creator mentions. Useful for bulk data access. For recommendation use cases, prefer /api/v1/recommendations.

Params: q, brand, category, subcategory, price_tier, retailer, limit
curl "https://grailpeople.com/api/v1/products?q=blush&category=FACE&price_tier=drugstore&limit=5"
GET/api/v1/brands

All indexed brands with public products, retailer lists, top subcategories, and AI-generated summary fields when available.

curl "https://grailpeople.com/api/v1/brands"
GET/api/v1/creators

All indexed creators with subscriber counts and product totals.

Params: platform, min_products
curl "https://grailpeople.com/api/v1/creators"

Browse

Each creator and product has an HTML page with structured JSON-LD for AI indexing.

Creator profiles

Product history, creator quotes, and source videos — grouped by category and subcategory.

Evelyn OrtizAashi AdaniAbbey YungAbby Malyszka ⚘Aditya MadirajuAlegra Chettialenaalessya farrugiaAlexandra AneleAli Andreea
https://grailpeople.com/creators/[handle]
Product pages

Canonical product data with creator evidence, quotes, endorsement signals, and retailer info.

https://grailpeople.com/products/[slug]

Product slugs are returned in API responses as product_slug.

openapi.jsonMachine-readable v1 API schemallms.txtPlain-text API guide for AI agents and crawlerssitemap.xmlAll creator and product URLs for search indexing

Category values

FACELIPEYESSKINCAREBATH_BODYHAIRTOOLSOTHER

MCP Server

GrailPeople ships an MCP server so AI assistants like Claude can query the API directly. Four tools are available.

search_productsFind creator-backed recommendations by concern, ingredient, budget, or skin type.
get_product_evidenceFull creator evidence dossier for one product — quotes, timestamps, caveats.
get_brand_intelAI-generated brand verdict, signature products, and creator-backed trust signals.
get_creator_picksAll products a specific creator endorses, with their exact words and video timestamps.
claude mcp add grailpeople -- node --env-file=apps/.env --experimental-strip-types apps/scripts/mcp-server.ts

What's in the data