{"uid":"cap__ths2lTO5gzGIuCTQnZNO","slug":"agents-dubbleblack-com-dubbleblack-evidence-ranked-product-eb777b2a","name":"DubbleBlack Evidence-Ranked Product Recommendation API","description":"Canonical paid interface backed by Evidence Engine V2. Submit a natural-language query; vertical is an optional routing hint. Explicit two-subject text comparisons return independently attributed evidence, coverage, provenance, limitations, and per-subject scores, with no winner or aggregate comparison score. A one-element brands array is accepted for single-subject compatibility. budget_min, budget_max, and include_insufficient_evidence are rejected; ambiguous multi-selector requests are reject","url":"https://agents.dubbleblack.com/api/agent/evidence?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":{"properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false}}},"responseSchema":{"type":"object","required":["schema_version","generated_at","evidence_available","evidence","errors"],"properties":{"errors":{"type":"array","items":{"type":"string"}},"coverage":{"type":"object","additionalProperties":true},"evidence":{"type":"array","items":{"type":"object","additionalProperties":true}},"provenance":{"type":"array","items":{"type":"object","additionalProperties":true}},"generated_at":{"type":"string","format":"date-time"},"evidence_score":{"type":["object","null"],"description":"Calibrated bounded Evidence Score V1 with score, band, components, formula, explanation, and limitations.","additionalProperties":true},"schema_version":{"type":"string"},"evidence_available":{"type":"boolean"},"comparison_subjects":{"type":"array","items":{"type":"object","additionalProperties":true},"description":"Present only for explicit two-subject text comparisons. Each entry carries its own subject, evidence, coverage, provenance, limitations, and score; no winner is calculated."}},"description":"V2 response. Evidence Score V1 measures bounded evidence strength/depth only; it is not product quality, recommendation confidence, or purchase probability.","additionalProperties":true},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":5,"rating":{"score":"0.38","successRate":"0.98","reviews":5,"stars":"2.5","state":"rated"},"availabilityStatus":"healthy","priceObserved":{"p10Cents":"10.0000","medianCents":"10.0000","p90Cents":"10.0000","minCents":"10.0000","maxCents":"10.0000","p95Cents":"10.0000","sampleCount":17,"varies":false,"failureChargeRate":null},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.1","per":"call","confidence":"exact"},{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_PeDf-1YiO5tSltSiAuqzq","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_bU0f2I6Bfx-tBd3kTMMSc","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.dubbleblack.com","brandSlug":"agents-dubbleblack-com-x402","brandBaseUrl":"https://agents.dubbleblack.com","brandDocsUrl":null,"whatItDoes":"Returns ranked product recommendations with evidence scores, confidence bands, and provenance metadata derived from aggregated first-party behavioral and verified transaction data for a given vertical, category, and purchase intent.","exampleAgentPrompt":"Can you find me the top 3 evidence-backed pet nutrition products in the companion animal vertical for a senior dog with a sensitive stomach, keeping budget under $60?","exampleUseCases":[{"title":"Senior pet food recommendation","prompt":"I need to find the best dog food options for my aging Labrador who has a sensitive stomach — can you pull the top 3 evidence-ranked picks from the companion animal vertical in pet nutrition, ideally under $80?"},{"title":"Skin care product discovery","prompt":"What are the top 5 personal care products with strong evidence scores for moisturizing dry skin? Keep results within the personal care vertical and limit to brands like CeraVe and Neutrogena."},{"title":"Budget wellness tech selection","prompt":"Find me the top 3 wellness tech devices under $100 that have solid evidence backing for improving sleep quality — I want to see the confidence bands and how many sources back each one up."}],"resultDescription":"A JSON object containing: the echoed query parameters, an array of ranked product results (each with rank, product name, brand, SKU, category, vertical, evidence score 0-1, evidence band label (high/moderate/limited/insufficient), evidence summary, component scores, source type counts, data provenance metadata, profile status, and recommendation eligibility flag), and optionally a list of non-fatal errors. If evidence is too sparse, returns HTTP 200 with an empty results array and insufficient_evidence set to true.","failureModes":["Sparse observations: HTTP 200 with empty results array and insufficient_evidence=true — not an error, just honest signal","Invalid vertical enum value: validation error returned","Budget min greater than budget max: likely returns empty or error in errors array","No products match combined brand + category + budget filters: empty results","Network or upstream DubbleBlack service outage: HTTP 5xx"],"whenToPreferThis":"Choose this endpoint when you need evidence-grounded product recommendations backed by verified consumer behavioral data rather than catalog metadata or LLM-generated suggestions. It is especially valuable when recommendation trustworthiness and data provenance matter — e.g., health, nutrition, or wellness contexts — and when you need explicit confidence bands to decide whether to surface or withhold a recommendation. Prefer it over generic product search APIs when you want ranked outputs with transparency about evidence quality and source counts.","instructions":null,"reviewSummary":"Returns ranked product recommendations with evidence scores and provenance metadata, but coverage is severely limited in practice: most queries across multiple claimed verticals and categories return empty results with insufficient_evidence=true. One confirmed data-bearing response covered only a single brand in the companion animal CBD category, with useful ranking scores and metadata delivered in ~6 seconds. Reliability is mixed — the MPP payment lane works, but the x402 lane enters a re-challenge loop, and at least one response exposed an internal SQL error alongside an allowance outage.","reviewSummaryHighlights":["When evidence exists, returns ranked SKUs with scores, outcome counts, and provenance metadata in ~6s","MPP/Tempo payment lane completes successfully with consistent HTTP 200 responses","Never fabricates results — correctly returns empty array with insufficient_evidence flag when data is sparse"],"reviewSummaryConcerns":["Inventory appears largely empty or unreachable; the majority of queries across all claimed categories return no results","x402 payment lane enters an infinite re-challenge loop despite verified payment, leaving calls unresolved","Internal SQL parameter-binding errors and allowance outages observed in production responses"],"reviewSummaryGeneratedAt":"2026-09-24T04:15:07.488Z","activationCount":69,"lastUsedAt":"2026-10-07T23:02:16.463Z","lastSuccessfullyRanAt":"2026-10-07T23:02:16.463Z","lastHealthCheckAt":"2026-10-13T02:00:06.340Z","isFirstParty":false,"canonicalSlug":"agents-dubbleblack-com-dubbleblack-evidence-ranked-product-eb777b2a"}