{"uid":"cap_AizPUbTYBdr5wPeZYn95T","slug":"bananabread-consumer-sentiment-api-99e8d92c","name":"BananaBread Consumer Sentiment API","description":"Consumer sentiment for a food, drink, supplement, skincare or beauty product: what shoppers say about it on Amazon, TikTok, Reddit, YouTube, Instagram, Walmart and more, grouped into what they love, wish for and complain about, with verbatim quotes and source links. The response holds the product id and a read_token; the report is ready a few minutes later at GET /v1/products/{id}/consumer-sentiment with Authorization: Bearer <read_token>.","url":"https://product-api.bananabread.ai/v1/products?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["name","brand","lang"],"properties":{"lang":{"enum":["en","nl"],"type":"string","description":"Language of the input"},"name":{"type":"string","minLength":1,"description":"Product name"},"brand":{"type":"string","minLength":1,"description":"Brand name"},"barcode":{"type":"string","description":"UPC or EAN, 8, 12, 13 or 14 digits with a valid check digit"},"variant":{"type":"string","maxLength":64,"description":"Flavour, size or edition"},"description":{"type":"string","description":"Optional free-text description"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.99","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.99/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.99","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.99","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_UK9h_UPxUHxBXEROoUbVM","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.99","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes consumer sentiment for food, drink, supplement, skincare, or beauty products by aggregating reviews from Amazon, TikTok, Reddit, YouTube, Instagram, Walmart and more into structured love/wishlist/complaint themes with quotes and source links.","exampleAgentPrompt":"Pull together what shoppers are saying about Vital Proteins Collagen Peptides by Vital Proteins — what they love, wish for, and complain about — pulling from Amazon, TikTok, Reddit and similar platforms, in English.","exampleUseCases":[{"title":"Competitive product research for a brand","prompt":"What are shoppers saying about Olipop Cherry Vanilla soda by Olipop on Amazon, Reddit, and TikTok? I want to know what they love, what they wish was different, and what they complain about."},{"title":"Pre-launch consumer insight for a new supplement","prompt":"Can you get me a full consumer sentiment report for Athletic Greens AG1 by Athletic Greens in English — I need the verbatim quotes and source links for what fans love and what critics hate."},{"title":"Skincare influencer due-diligence check","prompt":"What are real shoppers saying about CeraVe Moisturizing Cream by CeraVe across YouTube, Instagram, and Walmart reviews? Give me a breakdown of compliments, complaints, and wishes."}],"resultDescription":"Returns a product ID and a read_token immediately after submission. The full sentiment report — including grouped themes of what shoppers love, wish for, and complain about, along with verbatim quotes and links to source reviews — becomes available a few minutes later via GET /v1/products/{id}/consumer-sentiment using the read_token as a Bearer token.","failureModes":["Missing required fields (name, brand, or lang) returns a validation error","Invalid or malformed barcode (bad check digit or wrong length) causes rejection","Unsupported language code (only 'en' and 'nl' accepted) returns an error","Report not yet ready when polling too soon — retry after a few minutes","Insufficient USDC balance or x402 payment failure blocks request processing","Product not found on monitored platforms may result in an empty or sparse sentiment report"],"whenToPreferThis":"Choose this endpoint when you need multi-platform consumer sentiment specifically for tangible consumer goods — food, drink, supplements, skincare, or beauty — and want structured, theme-grouped insights (love/wish/complaints) with source-linked verbatim quotes rather than raw review data or a single-platform scrape. It is especially useful when you need cross-platform aggregation across Amazon, TikTok, Reddit, YouTube, Instagram, and Walmart in a single call rather than building your own scraping pipeline.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T06:38:12.761Z","isFirstParty":false,"canonicalSlug":"bananabread-consumer-sentiment-api-99e8d92c"}