{"uid":"cap_-nr0rp-lFKXQCnjEZMphi","slug":"scentpulse-occasion-match-6efb3640","name":"ScentPulse Occasion Match","description":"Fragrance recommendations by occasion, season, climate, age, and budget — including hot-climate projection and longevity guidance for Gulf, Southeast Asia, and Latin America buyers, a detail most Western fragrance media skips.","url":"https://scentpulse-xi.vercel.app/api/scent/occasion-match","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"},"season":{"type":"string","description":"spring | summer | fall | winter (optional)"},"climate":{"type":"string","description":"hot-humid | hot-dry | temperate | cold (optional)"},"occasion":{"type":"string","description":"office | date night | wedding | signature scent (optional)"},"age_range":{"type":"string","description":"20s | 30s | 40s+ (optional)"},"budget_usd":{"type":"string","description":"optional"}}}},"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":{"recommendations":[{"fragrance":"Terre d'Hermes","why_it_fits":"Versatile mineral-woody, strong hot-climate performer"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_tQ-9CK3GFLiYV4uqn8ZaU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns fragrance recommendations tailored to a specific occasion, setting, or context based on fragrance intelligence","exampleAgentPrompt":"What fragrance should I wear to a formal outdoor summer wedding — something versatile, mineral or woody, that holds up in heat?","exampleUseCases":[{"title":"First date fragrance recommendation","prompt":"I have a romantic dinner date this Saturday evening at an upscale restaurant — what fragrance would ScentPulse recommend I wear to make a great impression without being overpowering?"},{"title":"Business travel scent selection","prompt":"I'm heading to Dubai for a week of client meetings in July — can you find me a fragrance that's professional, performs well in extreme heat, and isn't too loud for close quarters?"},{"title":"Blind-buy occasion validation","prompt":"I'm thinking of blind-buying Terre d'Hermès for everyday office wear in autumn — does ScentPulse think it's a good fit for that occasion, and are there similar alternatives if not?"}],"resultDescription":"A JSON array of fragrance recommendations, each with the fragrance name and a concise explanation of why it fits the specified occasion — including notes on performance characteristics like climate suitability, projection, and accord style.","failureModes":["Missing or invalid occasion parameter returns an error or empty recommendations","Overly vague occasion input may yield generic or low-confidence matches","Payment header missing or invalid results in 402 Payment Required response","Unsupported occasion type or out-of-vocabulary input may return no results","Network or server errors from the Vercel deployment may cause intermittent 5xx failures"],"whenToPreferThis":"Choose this endpoint when the user wants fragrance recommendations contextualized to a specific event, environment, or mood — as opposed to note-profile lookup (which describes a known fragrance) or dupe-finding (which seeks cheaper alternatives). Ideal for blind-buyers seeking occasion guidance or collectors deciding what to reach for.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:42:35.640Z","isFirstParty":false}