{"uid":"cap_QjXaqkn8fROnAB5vNjO4D","slug":"scentpulse-price-per-ml-36947e1f","name":"ScentPulse Price-Per-ML","description":"Fragrance price-per-ml value calculator — normalizes cost across full bottles, gift sets, decants, and travel sprays to surface the cheapest legitimate way to try or own a fragrance.","url":"https://scentpulse-xi.vercel.app/api/scent/price-per-ml","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":"Dior | Carolina Herrera (optional)"},"fragrance":{"type":"string","description":"Sauvage EDT | Good Girl (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":"Sauvage EDT","size_options":[{"size_ml":100,"approx_price_usd":95,"price_per_ml_usd":0.95}]}},"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_P5PMX9LuR4y4_ytGabAmd","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 price-per-milliliter cost breakdown for a named fragrance across available bottle sizes","exampleAgentPrompt":"What's the price per ml for Dior Sauvage EDT — I want to see the breakdown across all available bottle sizes so I can figure out which one gives the best value.","exampleUseCases":[{"title":"Best bottle size value check","prompt":"I'm deciding between the 50ml and 100ml of Tom Ford Oud Wood — can you pull the price-per-ml breakdown for both sizes so I know which one is actually the better deal?"},{"title":"Dupe cost justification","prompt":"A dupe of Creed Aventus is being sold as a better value — can you look up the price per ml for Creed Aventus so I can compare whether the dupe is actually worth it at its price?"},{"title":"Blind buy budget planning","prompt":"I'm considering blind buying a bottle of Amouage Interlude Man but I'm not sure which size makes sense for my budget — what does the price per ml look like across the available sizes?"}],"resultDescription":"A JSON object containing the fragrance name and an array of size options, each with the bottle volume in ml, the approximate retail price in USD, and the calculated price-per-ml in USD. Allows direct value comparison across sizes.","failureModes":["Fragrance not found in database — returns empty or error response","Ambiguous fragrance name with multiple flankers may return unexpected variant","Price data may be stale if market prices have shifted","Only approximate retail prices, not current sale or resale prices","Payment signature missing or invalid — returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need to calculate or compare the per-milliliter cost efficiency of a specific named fragrance across bottle sizes. Ideal for dupe-hunters justifying alternatives, collectors evaluating purchase sizes, or blind buyers optimizing budget. Prefer this over general retail search when you want a structured cost-per-ml metric rather than raw listing prices.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:38:23.853Z","isFirstParty":false}