{"openapi":"3.1.0","info":{"title":"DubbleBlack","version":"1.0.0","description":"DubbleBlack Powder provides aggregated first-party behavioral and verified transaction evidence for product recommendations. Given a vertical, category, and purchase intent, the API returns ranked products with evidence scores, confidence bands, and provenance metadata, so recommendations are grounded in real consumer behavior rather than catalog data alone. When observations are too sparse to support a confident recommendation, the API returns an explicit insufficient evidence signal instead of fabricated results. This server is a pay-per-use, transparent proxy in front of DubbleBlack's own API: it handles identity, payment, and proxying. Agents can purchase autonomously or with their human's approval. This document is the source of truth for agents: it lists the complete verified paid surface with each operation's live price in its x-payment-info. Endpoints not listed here are not part of the supported catalog. The live catalog at /manifest.json is authoritative for prices and any free included units (prices[].includedUnits) - some meters include free usage per account before any charge, reserved for agents claimed by a human with a verified email.","x-guidance":"Call the operations listed in this document at https://agents.dubbleblack.com. An unpaid call returns 402 Payment Required with a signed challenge; settle it with a supported payment method - x402 (Base USDC) or MPP (Tempo USDC) today - and retry with the proof attached. No upstream API key is needed, and an agent without a payment method can set one up instantly at no cost. Read GET https://agents.dubbleblack.com/zcj/dugs30qwrf8x/manifest.json for the live services, meters, plans, prices, and any free included units, and https://agents.dubbleblack.com/zcj/dugs30qwrf8x/llms-full.txt for the full agent guide, including how the free allowance works without funding (it requires an agent identity claimed by a human with a verified email)."},"x-service-info":{"docs":{"homepage":"https://dubbleblack.com","apiReference":"https://agents.dubbleblack.com/zcj/dugs30qwrf8x/openapi.json","llms":"https://agents.dubbleblack.com/zcj/dugs30qwrf8x/llms.txt"}},"externalDocs":{"url":"https://agents.dubbleblack.com/zcj/dugs30qwrf8x/llms-full.txt","description":"How to authenticate, pay, and call this API; links the upstream API reference."},"servers":[{"url":"https://agents.dubbleblack.com/zcj/dugs30qwrf8x","description":"Pay-per-use access to DubbleBlack's API"}],"security":[{"payPerUse":[]}],"components":{"securitySchemes":{"payPerUse":{"type":"apiKey","in":"header","name":"x-payment","description":"Pay-per-use access. An unpaid call returns 402 Payment Required with a signed challenge; settle it with a supported payment method (x402 or MPP today) and retry with the proof in this header (x402) or as an authorization bearer credential (MPP). No upstream API key is needed, and an agent without a payment method can set one up instantly at no cost."}}},"paths":{"/api/agent/evidence":{"post":{"summary":"Query ranked product recommendation evidence","description":"Returns ranked products with evidence scores, confidence bands, and provenance metadata for a vertical, an optional category, and a natural language purchase intent. Supports budget, brand, and product ID filters. When observations are too sparse to support a confident recommendation, the API returns HTTP 200 with an empty results array and insufficient_evidence set to true. It never fabricates results.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","example":{"limit":3,"intent":"senior dog with sensitive stomach","category":"pet_nutrition","vertical":"companion_animal"},"required":["vertical"],"properties":{"limit":{"type":"integer","default":5,"example":3,"maximum":10,"minimum":1,"description":"Maximum results to return."},"brands":{"type":"array","items":{"type":"string","maxLength":128},"maxItems":20,"description":"Restrict results to specific brands."},"intent":{"type":"string","example":"senior dog with sensitive stomach","maxLength":512,"description":"Natural language purchase intent."},"category":{"type":"string","example":"pet_nutrition","maxLength":128,"description":"Product category filter, matched as a substring."},"vertical":{"enum":["companion_animal","food_beverage","personal_care","wellness_tech","general_retail"],"type":"string","example":"companion_animal","maxLength":64,"description":"Category vertical slug."},"budget_max":{"type":"number","minimum":0,"description":"Maximum price filter in USD."},"budget_min":{"type":"number","minimum":0,"description":"Minimum price filter in USD."},"product_ids":{"type":"array","items":{"type":"string","maxLength":128},"maxItems":20,"description":"Restrict results to specific product IDs."}}}}}},"x-payment-info":{"protocols":[{"mpp":{"method":"tempo","intent":"charge","currency":"USD"}},{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC"}}],"offers":[{"amount":null,"currency":"0x20C000000000000000000000b9537d11c60E8b50","description":"$0.100000 per request (requests)","intent":"charge","method":"tempo"}],"price":{"mode":"dynamic","currency":"USD","min":"0.100000"}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"object","description":"Exact input parameters echoed back."},"errors":{"type":"array","items":{"type":"string"},"description":"Non fatal error messages, omitted on clean success."},"results":{"type":"array","items":{"type":"object","properties":{"sku":{"type":["string","null"]},"rank":{"type":"integer","description":"1-based rank by descending evidence score."},"brand":{"type":["string","null"]},"category":{"type":["string","null"]},"offer_id":{"type":["string","null"]},"vertical":{"type":["string","null"]},"product_id":{"type":["string","null"]},"methodology":{"type":"string","description":"Description of the evidence methodology."},"product_name":{"type":["string","null"]},"source_count":{"type":["integer","null"],"description":"Number of distinct evidence sources."},"evidence_band":{"enum":["high","moderate","limited","insufficient",null],"type":["string","null"]},"evidence_label":{"type":["string","null"],"description":"Human readable label for evidence_band."},"evidence_score":{"type":["number","null"],"description":"Evidence confidence score on a 0 to 1 scale."},"profile_status":{"enum":["current","stale",null],"type":["string","null"]},"data_provenance":{"type":"object","properties":{"source":{"type":"string"},"source_type":{"type":"string"},"derived_or_raw":{"type":"string"},"commercialization_rights":{"type":"string"}}},"profile_version":{"type":["string","null"]},"component_scores":{"type":["object","null"],"description":"Per component confidence scores."},"confidence_score":{"type":["number","null"],"description":"Same value as evidence_score."},"evidence_summary":{"type":["string","null"],"description":"Short text summary of the evidence basis."},"source_type_counts":{"type":["object","null"],"description":"Counts broken down by source type."},"scoring_model_version":{"type":["string","null"]},"evidence_calculated_at":{"type":["string","null"],"format":"date-time"},"recommendation_eligible":{"type":["boolean","null"]}}},"description":"Ranked product evidence results."},"generated_at":{"type":"string","format":"date-time","description":"UTC timestamp of query execution."},"schema_version":{"type":"string","description":"Always 1.0."},"evidence_version":{"type":"string","description":"Always 1.0."},"results_returned":{"type":"integer","description":"Count of items in results."},"average_confidence":{"type":["number","null"],"description":"Mean confidence_score across results, null if no results."},"insufficient_evidence":{"type":"boolean","description":"True when results is empty because observations are too sparse to support a confident recommendation."}}}}}},"402":{"description":"Payment required"}}}}}}