---
title: "How to use DubbleBlack's Powder Evidence with your AI agent | ZeroClick"
url: https://zeroclick.ai/resources/how-to-use-dubbleblack-with-your-ai-agent
fetched_at: 2026-11-05T05:41:29.569Z
---

# ZeroClick API catalog and pricing

## API reference, endpoint lookup and prices

**[ZeroClick API catalog: endpoints, request parameters, prices and payment methods](https://agents.zeroclick.ai/zcj/l9r8bmz3iadt/zeroclick/agent/guide).** Tell the seller advisor what you want to accomplish. It returns the matching operation contract, known prices, authentication prerequisites and concrete next steps. It is read-only: no login, wallet, card or purchase approval is needed to look up an API. It never executes a sale.

Available API services: Agent readiness report, Demo booking.

**Suggested next request:** GET [task guide](https://agents.zeroclick.ai/zcj/l9r8bmz3iadt/zeroclick/agent/guide?goal=URL_ENCODED_TASK). Use this URL directly with your web fetch tool; no preliminary document fetch is required. Include known inputs and desired output in the goal. Optional: quantity=API_CALL_COUNT, budgetUsd=TOTAL_USD, requirements=REQUIREMENTS, payment=x402|mpp|card, auth, identity, assertion and access state. Omit unknowns. Do not equate output items with API calls or guess a call count.

For private task details or known request arguments, POST https://agents.zeroclick.ai/zcj/l9r8bmz3iadt/zeroclick/agent/guide with Content-Type: application/json. Example: {"intent":"quote","goal":"YOUR_TASK","purchase":{"budgetUsd":"5.00"}}. Replace the task and budget with known facts; budgetUsd is a string. Include known buyerState, paymentCapabilities and arguments. For execution planning use intent=execute and the authorized constraints. Exact fields: [request schema](https://agents.zeroclick.ai/zcj/l9r8bmz3iadt/zeroclick/agent/schema). GET and POST are alternatives, not mandatory stages.

The advisor describes a recommended happy path, not the only allowed path. You may use the API reference, buyer SKILL and your own tools directly, including for catalog operations with failed probes. Missing guidance or an unverified probe is not a policy refusal. The returned requests are documented API calls; fill in the documented inputs. Check usage cost AND minimum cash required against the budget. For needs_input, supply only missing facts. Keep secrets local, and never put credentials or private payloads in URLs. Unknown does not mean absent.

For a human's credit or plan purchase, reuse an existing ZeroClick credential first. If the Link CLI is already installed and signed in for that person, you can use their Link account for identity as well as payment, sharing their email only if they agree: follow [Link identity setup](https://agents.zeroclick.ai/zcj/l9r8bmz3iadt/auth.md#link-identity-preview) through issuance, presentation, registration and token exchange. Otherwise register anonymously; no Link setup is needed, and the person can claim the identity later.

Open the checkout URL in a browser: eligible Stripe pages support Link Pay Tokens (LPT) through WebMCP or the documented DOM flow. Follow this storefront's /payment/card.md to verify the same-frame token input and merchant binding before requesting an LPT. Token submission requires payment authorization. If unavailable, privately send the checkout URL to your human to pay.

When the selected route uses hosted checkout, follow [card checkout instructions](https://agents.zeroclick.ai/zcj/l9r8bmz3iadt/payment/card.md) before requesting a token. LPT goes only to Stripe, never to the advisor or ZeroClick API. Poll the returned statusUrl before using credit or retrying delivery.

Verify delivery; a payment or HTTP 202 is not completion. For an unexpected result, POST the original input and continuation (version, stepId, outcome and sanitized error/accessId/paymentId). Reconcile uncertain payments or writes before retrying. Use raw HTTP for exact schemas and authenticated execution; do not reconstruct fields omitted by a summarizing web tool.

The human subscription prices on the requested page describe a separate channel. Use the API quote for per-unit pricing, funding minimums and commercial terms; tier names do not prove quality or licensing.

For an alternative documented path, use the [buyer SKILL](https://agents.zeroclick.ai/zcj/l9r8bmz3iadt/SKILL.md) or [full direct workflow reference](https://agents.zeroclick.ai/zcj/l9r8bmz3iadt/llms-full.txt). Confirm missing request details from seller documentation, stay within the existing catalog and what your user asked for, and respect actual access and payment requirements.
Terms: by completing a purchase through this endpoint, whether directly or through an AI agent acting on your behalf, you agree to be bound by the platform's buyer terms of service (https://www.zeroclick.ai/legal/buyer-terms-of-service). If the purchase is made by an agent, you represent and warrant that the agent is acting with your authorization, and you agree that the agent's actions, including its acceptance of these terms, are attributed to you and bind you as if you had taken them yourself. Paying a 402 challenge completes the purchase and constitutes your affirmative acceptance of the terms linked above. The link travels in every payment challenge and receipt as `terms`.

# How to use DubbleBlack's Powder Evidence with your AI agent

*Published October 20, 2026 · 11 min read · [ZeroClick](https://x.com/zeroclick)*

DubbleBlack's Powder Evidence tells your AI agent what shoppers did around a product before the agent recommends one. Each answer carries the commerce evidence, where it came from, how much of the question it covers, and an Evidence Score for its strength. Each question costs $0.10. DubbleBlack sells through ZeroClick: your agent sends its question to the [DubbleBlack storefront](https://agents.dubbleblack.com), pays that one request over x402 or MPP, and reads the answer, with no signup and no API key.

**Contents**

- [What DubbleBlack is](#what-dubbleblack-is)
- [What agents use DubbleBlack for](#what-agents-use-dubbleblack-for)
- [Prices](#prices)
- [How to buy and call DubbleBlack from your agent](#how-to-buy-and-call-dubbleblack-from-your-agent)
- [Example requests](#example-requests)
- [If your agent has no wallet](#if-your-agent-has-no-wallet)
- [What to know](#what-to-know)
- [Frequently asked questions](#frequently-asked-questions)

**Key points**

- Send a natural-language question to `POST https://agents.dubbleblack.com/api/agent/evidence`, pay the priced 402 that comes back, and retry the identical request with the proof.
- Keep questions inside Powder's categories (pet, snacks and confectionery, beauty, personal care and household). An off-category question returns a gap and still costs a request.
- Read the coverage, provenance, limitations, and Evidence Score, then let your agent make the recommendation. Powder does not make one.
- An agent without a wallet can create one at no cost, or buy prepaid Credits by card from $0.50.

## What DubbleBlack is

DubbleBlack is a behavioral commerce intelligence company. Its vertical networks collect commerce signals from real shopping activity: Foodience in food and nutrition, Pawdience in pet, and Radience in beauty and wellness. Its Powder platform turns those signals into evidence an agent can weigh. Powder gives your agent evidence for commerce decisions, and your agent decides how to use it.

That division of labour suits a shopping, gift, or comparison assistant. A product listing tells an agent what a thing is. It does not tell the agent what shoppers clicked on or went on to buy, and that behavior is what a recommendation rests on. Powder supplies it one question at a time. When it holds nothing relevant, the answer says so plainly. The full story of the partnership is in [DubbleBlack x ZeroClick: commerce evidence any agent can buy](https://zeroclick.ai/blog/dubbleblack-commerce-evidence-any-agent-can-buy).

An agent storefront is a business published for machines. It is a URL where an agent reads what is for sale, the live prices, and the steps to pay, then buys without a person filling in forms. DubbleBlack's storefront runs on its own domain and sits in front of DubbleBlack's API as a transparent proxy that takes payment and forwards the request. For how storefronts work, see [What is an agent storefront?](https://zeroclick.ai/resources/what-is-an-agent-storefront)

## What agents use DubbleBlack for

Powder answers one kind of question in several shapes. Every one goes to the same endpoint: `POST /api/agent/evidence`.

| Job your agent is given | What to send | What comes back |
|---|---|---|
| Check shopper evidence before suggesting a calming chew for a dog | `query` in plain words, optional `vertical` hint | Evidence, provenance, coverage, limitations, Evidence Score |
| Shortlist a facial moisturizer or cleanser for a beauty assistant | `query`, with `limit` from 1 to 10 | The same fields, up to `limit` results |
| Pick snacks, nuts, or peanut brittle for a gift list | `query` | The same fields |
| Compare two products side by side | A `query` that names exactly two subjects | `comparison_subjects`, one entry per subject with its own evidence and score |
| Look up evidence for one brand or one product | `brand`, or one `product_ids`, `gtins`, or `skus` value | Evidence for that subject |
| Find out whether any evidence exists before citing it | Any of the above | A coverage state, which is `gap` when nothing relevant is held |

Powder holds evidence in pet calming, pet mobility, pet wellness, pet grooming, and pet treats. It also covers snacks, nuts, confectionery, beauty, personal care, and household. The evidence types are catalog data, behavioral clicks, and observed conversions. DubbleBlack's published inventory lists more than 150 retrievable evidence subjects, and coverage grows as new evidence is added. The example queries above are illustrations, not a closed list. The [API reference](https://agents.dubbleblack.com/services/powder-evidence/openapi.json) lists every field.

## Prices

| Route | Price | What it needs |
|---|---|---|
| Pay as you go | $0.10 per request | A USDC wallet on x402 or MPP; one 402 per call |
| Credits | $0.10 per request, drawn from a prepaid balance | A free agent credential; $0.50 minimum purchase, by wallet or card |

A gift assistant that checks five candidates spends $0.50. A two-product comparison is a single request, so it costs $0.10, the same as one question. A $10 Credits balance covers 100 questions, and the $0.50 minimum covers five. A gap costs the same as an answer full of evidence, so ten questions outside Powder's categories spend $1.00 for nothing your agent can use.

Prices come from the live [price list](https://agents.dubbleblack.com/manifest.json). Every 402 states the exact amount before your agent pays, so read the price at call time rather than caching it.

## How to buy and call DubbleBlack from your agent

1. Point your agent at the [agent guide](https://agents.dubbleblack.com/llms.txt) on DubbleBlack's storefront, which links the price list, the payment guide, and the API reference.
2. Check the question against Powder's [current categories](https://data.dubbleblack.com/capabilities), because a question outside them comes back as a gap and still costs a request.
3. If your agent is unsure how to shape the call, ask the free task guide at `https://agents.dubbleblack.com/zeroclick/agent/guide?goal=URL_ENCODED_TASK`, which needs no wallet and never buys anything.
4. Send `POST /api/agent/evidence` to the storefront with a JSON body holding a natural-language `query` and no payment header. The storefront answers with a priced 402.
5. Check the 402's `payment.amountUsd` against your budget before you pay.
6. Pay the challenge from your wallet, using x402 for USDC on Base or MPP for USDC on Tempo.
7. Retry the identical request, byte for byte, with the payment proof attached. The payment is bound to the body it priced.
8. Read `coverage`, `evidence`, `provenance`, `limitations`, and `evidence_score`, then let your agent decide what to recommend.

## Example requests

Send the question with no payment header. This body is DubbleBlack's own example, with `max_external_sources` set to 0 so the call draws on no outside sources (it takes 0 to 10 and defaults to 2):

```http
POST https://agents.dubbleblack.com/api/agent/evidence
Content-Type: application/json

{"query": "What calming CBD chews should I consider for my dog?", "limit": 3, "max_external_sources": 0}
```

The 402 body carries `payment.amountUsd`, the `plan`, and a `protocols` block with a challenge for each rail. The signable challenges also arrive as headers, so a standard x402 or MPP client can settle them without reading the body:

```http
HTTP/1.1 402 Payment Required
payment-required: <x402 challenge>
www-authenticate: <MPP challenge>
```

Sign the challenge and resend the same request with the proof. On x402 the payload goes in `x-payment`. On MPP, send `Authorization: Payment <credential>` instead:

```http
POST https://agents.dubbleblack.com/api/agent/evidence
Content-Type: application/json
x-payment: <signed x402 payload>

{"query": "What calming CBD chews should I consider for my dog?", "limit": 3, "max_external_sources": 0}
```

That question was sent and paid for $0.10 through Zero, ZeroClick's own payment layer for agents. The answer came back with the fields below, shown as types rather than values:

```json
{
  "schema_version": "<string>",
  "generated_at": "<string>",
  "evidence_available": "<boolean>",
  "evidence": [
    {
      "evidence_type": "<string>",
      "signal_type": "<string>",
      "observed_count": "<number>",
      "identity_granularity": "<string>",
      "product_name": "<string>",
      "brand": "<string>",
      "provenance": {"network": "<string>", "reporting_period_start": "<string>", "reporting_period_end": "<string>"},
      "limitations": ["<string>"]
    }
  ],
  "coverage": {"state": "<string>", "owned_evidence_available": "<boolean>"},
  "evidence_score": {"score": "<number>", "band": "<string>", "summary": "<string>", "components": {}, "formula": "<string>", "limitations": ["<string>"]},
  "provenance": [],
  "limitations": ["<string>"],
  "errors": []
}
```

A second question asked which cordless drill to buy for home projects, a question outside Powder's categories, and cost the same $0.10. The reply came back in about six seconds as a gap with no evidence and a score of 0:

```json
{
  "schema_version": "2.0",
  "evidence_available": false,
  "evidence": [],
  "results_returned": 0,
  "errors": [],
  "coverage": {"state": "gap", "owned_evidence_available": false},
  "evidence_score": {
    "score": 0,
    "band": "limited",
    "limitations": ["no relevant owned evidence"],
    "component_notes": {"score_meaning": "evidence strength only; not product quality or purchase likelihood"}
  },
  "coverage_state": "gap"
}
```

## If your agent has no wallet

- **Create a wallet.** Your agent can set one up itself, at no cost and with no signup, starting from the storefront's [agent guide](https://agents.dubbleblack.com/llms.txt), then follow the steps above.
- **Buy Credits by card.** A card pays for plans and for single calls priced at $0.50 or more, so it cannot pay a single $0.10 question, but it can fund Credits. Register a free agent credential with the [identity guide](https://agents.dubbleblack.com/auth.md). Then send `POST /plans/{planId}/purchase` with `Authorization: Bearer <token>` and a body such as `{"amountUsd": "5.00", "checkout": true}`. The Credits plan's id and `purchase.url` are in the price list. The reply is a hosted checkout page that a browser agent can pay with a Link Pay Token, or that a person can pay. Poll its `statusUrl` before calling. The [card checkout instructions](https://agents.dubbleblack.com/payment/card.md) cover the details.
- **Pay with a shared payment token.** For a purchase of $0.50 or more, such as Credits, a platform-granted `spt_` token answers the `method="stripe"` challenge on the card-eligible 402 in `Authorization: Payment <credential>`.
- **Hand off to a person.** Share any DubbleBlack page as `https://agents.dubbleblack.com/outclick?url={URL-encoded seller page}`, so DubbleBlack knows the visit came from an agent.

## What to know

**What Powder does not do.** Powder does not recommend or choose products, and a returned subject is not a recommendation. A comparison returns each subject's evidence separately, with no winner and no combined score. The Evidence Score runs from 0 to 100 and describes how strong and deep the evidence is. It does not measure how good a product is, how confident a recommendation should be, or how likely a purchase is. Observed conversions stay observed conversions, not confirmed purchases. Powder is not a web search engine, a general catalog, or a product availability service.

**What a gap means.** A gap means Powder found no relevant owned evidence. It is a successful, charged answer, not an API failure, and not negative evidence about a product. The current response reports coverage as owned, supplemented, external, or gap, alongside the evidence, its limitations, and the Evidence Score.

**Request limits.** A `query` can run to 2,000 characters and name at most two subjects. `brand`, `product_ids`, `gtins`, and `skus` each take one value. `budget_min`, `budget_max`, and `include_insufficient_evidence` are rejected. The preview route at `/api/agent/evidence/v2` is not the current paid default, so use `/api/agent/evidence`.

**What is charged, and when.** Each pay-as-you-go question is one 402 and one charge. Paying it completes the purchase under ZeroClick's buyer terms. A payment or an HTTP 202 does not mean delivery, so check the answer arrived. Unclaimed anonymous credentials expire, so read the [identity guide](https://agents.dubbleblack.com/auth.md) before relying on one for durable prepaid access.

**Errors worth handling.**

The [error reference](https://agents.dubbleblack.com/errors.md) lists every code. These are the ones your agent is most likely to meet:

| Error | What to do |
|---|---|
| 400 | Fix the body: a rejected field, an ambiguous selector, or more than two subjects. |
| 401 `bearer_required` | A Credits purchase needs a registered agent credential. Register, then retry with the bearer. |
| 409 `payment_request_mismatch` | The paid retry's body differed from the one priced. Get a new 402 for this request. |
| 429 | Rate limit exceeded. Wait before sending again. |
| 500 | The evidence service failed closed. Reconcile the payment before retrying. |
| `usage_exhausted` | The Credits balance ran out. Top up with `POST /extend`. |

## Frequently asked questions

### Does DubbleBlack need an API key for AI agents?

No. A pay-as-you-go call to the storefront is paid with a signed payment that proves control of your agent's wallet, so it needs no signup, account, or API key.

### How much does Powder Evidence cost?

Each request costs $0.10, whether it returns evidence or a gap. Prepaid Credits draw down at the same rate, from a $0.50 minimum purchase.

### What does a gap mean in a Powder response?

A gap means Powder holds no relevant owned evidence for the question. It is a successful, paid answer, not a judgement against the product.

### Can Powder compare two products?

Yes. A query that names exactly two subjects returns `comparison_subjects`, each with its own evidence, coverage, provenance, and score. Powder never picks a winner.

### Can my agent pay DubbleBlack without a crypto wallet?

Yes. It can create a free wallet, buy Credits by card from $0.50, or hand the purchase to a person, though a single $0.10 question cannot be paid by card.

### Do I have to use an AI agent to use DubbleBlack?

For Powder Evidence, yes. DubbleBlack sells it to AI agents, which buy on their own or with a person's approval. A person can start at [dubbleblack.com](https://dubbleblack.com), which introduces Powder and links its agent storefront.

---

**Related guides**

- [How to use Litescrape with your AI agent](https://zeroclick.ai/resources/how-to-use-litescrape-with-your-ai-agent) - Litescrape sells Google, Bing, Maps, and Shopping results as JSON to AI agents through ZeroClick, at $0.00015 per request from prepaid credit.
- [How to use OpenWeb Ninja with your AI agent](https://zeroclick.ai/resources/how-to-use-openwebninja-with-your-ai-agent) - OpenWeb Ninja sells live web data APIs to AI agents through ZeroClick. Most calls cost $0.003 against Credits from $0.50, and there is a free $0.15 trial.
- [How to use Keenable with your AI agent](https://zeroclick.ai/resources/how-to-use-keenable-with-your-ai-agent) - Keenable sells web search, page fetches, and SQL over the web to AI agents through ZeroClick, at $0.004 a call and $0.10 a SELECT, on Credits from $0.50.

[All resources](https://zeroclick.ai/resources) | [Documentation](https://zeroclick.ai/docs) | [Get started](https://zeroclick.ai/get-started)
