{"uid":"cap_4NRLwp4xN4A8cHhHHobso","slug":"scentpulse-fragrance-note-profile-lookup-519dd76d","name":"ScentPulse Fragrance Note Profile Lookup","description":"Fragrance note-profile lookup — note pyramid (top/middle/base), accord breakdown, molecule-level odor descriptors, who it suits, and occasion/climate fit for any perfume or cologne, grounded in fragrance community consensus and The Good Scents Company ingredient data.","url":"https://scentpulse-xi.vercel.app/api/scent/note-profile","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"lang":{"type":"string","description":"en | de | fr | es | ar | ja | ko | zh | pt"},"brand":{"type":"string","description":"Chanel | Maison Francis Kurkdjian | Dior (optional — helps disambiguate)"},"fragrance":{"type":"string","description":"Bleu de Chanel | Baccarat Rouge 540 | Sauvage (required — fragrance name)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"errors":{"type":"object","description":"Documented error responses, keyed by HTTP status code","additionalProperties":{"type":"object","required":["description"],"properties":{"example":{"type":"object"},"description":{"type":"string"}}}},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"fragrance":"Bleu de Chanel EDP","note_pyramid":{"top":["Grapefruit","Pink Pepper"],"base":["Sandalwood","Labdanum"],"middle":["Ginger","Nutmeg"]},"scent_family_dna":"Woody aromatic — fresh citrus opening resolving into a warm, incense-tinged woody base."}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.08","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.08/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_WU9AMUjGWzI6UH36NpS_v","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.08","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the full note pyramid (top/middle/base), accord breakdown, molecule-level odor descriptors, wearer suitability, and occasion/climate fit for any named perfume or cologne.","exampleAgentPrompt":"Can you pull up the full note pyramid and accord breakdown for Creed Aventus — top, middle, and base notes, plus molecule-level descriptors, who it suits, and what occasions and climates it works best for?","exampleUseCases":[{"title":"Summer fragrance climate check","prompt":"I'm trying to decide between Bleu de Chanel and Acqua di Giò for a beach holiday in July — can you pull up the full scent profiles for both and tell me which one is actually built for hot, humid weather and outdoor occasions?"},{"title":"Gift fragrance suitability match","prompt":"I want to buy a perfume for my mom — she's in her 50s, loves understated elegance, and usually wears things to dinner parties and the theatre. Can you look up Chanel No. 5 and Yves Saint Laurent Libre and tell me who each one suits best and what occasions they're made for?"},{"title":"Signature scent layering guide","prompt":"I've heard Jo Malone Wood Sage and Sea Salt layers really well with other fragrances — can you break down its full note pyramid, the accords, and the molecule-level descriptors so I can figure out what base notes to look for in a second scent to layer it with?"}],"resultDescription":"A structured fragrance profile including: layered note pyramid (top/middle/base notes), accord breakdown (e.g. fruity, woody, smoky), molecule-level odor descriptors grounded in The Good Scents Company data, description of who the fragrance suits, and recommended occasion and climate pairings.","failureModes":["Unknown or misspelled fragrance name returns no results or closest match","Very niche or indie fragrances with limited community data may have sparse profiles","Ambiguous fragrance names (e.g. 'Rose') may require disambiguation","Rate limiting or payment failure returns 402 error","API outage on Vercel deployment returns 503"],"whenToPreferThis":"Use this endpoint when you need structured, molecule-grounded fragrance intelligence for a named perfume or cologne — including note pyramid, accords, wearer suitability, and occasion/climate fit — rather than general product information, pricing, or reviews. Prefer this over generic search when you need the olfactive breakdown specifically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:32:16.189Z","isFirstParty":false}