// REDDIT DEMAND DATA API

A Reddit demand data API for AI agents

Demandex is a pay-per-call Reddit demand data API for AI agents — it mines public Reddit complaint and purchase-intent posts across 82 communities and returns them as classified, scored demand signals rather than raw threads. Instead of proxying the Reddit firehose, it delivers evidence-backed opportunity cards and cold/warm/hot demand verdicts, priced by the call in USDC on Base via x402 with no signup and no API keys. It is for agents, builders, and sellers who want to know what buyers are asking for but cannot find — physical products only, and informational rather than a guarantee of any outcome.

What the demand data looks like

  • Demand verdicts — POST /v1/gauge (7-day cached, corpus-only) and POST /v1/gauge/live (backed by a fresh Reddit search) score any physical-product query cold/warm/hot with a rationale, top evidence quotes, and related opportunities.
  • Opportunity cards — /v1/opportunity returns score components (frequency, intensity, willingness-to-pay), a product angle, and verbatim evidence[] with subreddit, upvotes, and permalinks.
  • Trending & category lists — /v1/opportunities/trending and /v1/opportunities?category= surface the highest-scored demand across the mined corpus.
  • Free to learn the shape — /v1/categories and /v1/sample/opportunity cost nothing so you can inspect the response contract first.
RouteMethodPrice
/.well-known/hexanonGETFREE
/v1/categoriesGETFREE
/v1/sample/opportunityGETFREE
/v1/opportunities/trendingGET$0.01
/v1/opportunitiesGET$0.02
/v1/opportunityGET$0.05
/v1/briefGET$0.25
/v1/gaugePOST$0.03
/v1/gauge/livePOST$0.10

Prices come straight from the service manifest. See the full pricing table or read what Demandex is.

How agents pay

Call any paid route with no payment and Demandex replies with an HTTP 402 x402 challenge (USDC on Base). Your client signs the exact-scheme USDC authorization for the Base accepts[] rail and retries with the PAYMENT-SIGNATURE (x402 V2) or X-PAYMENT (legacy) header. Compute-first / settle-after: you are never charged for an error. A first call over the demand data:

curl -sS -X POST https://api.demandex.dev/v1/gauge -d '{"query":"sony xm5 replacement headband"}'

For agents

Everything is machine-readable — start at llms.txt.

llms.txtapi.demandex.dev/llms.txtllms-full.txtapi.demandex.dev/llms-full.txtopenapi.jsonapi.demandex.dev/openapi.json.well-known/x402api.demandex.dev/.well-known/x402.well-known/agent-card.jsonapi.demandex.dev/.well-known/agent-card.jsondiscoveryapi.demandex.dev/discovery

FAQ

Is Demandex a Reddit demand data API?
Yes. Demandex mines public Reddit complaint and purchase-intent posts across 82 communities and turns them into structured demand data: scored opportunity cards and demand verdicts, each backed by verbatim quotes with subreddit, upvotes, and permalinks. You query it per call over HTTP; it is not a raw Reddit proxy — it returns classified, clustered, scored signal.
How is this different from calling the Reddit API myself?
The Reddit API (or PRAW) gives you raw posts; you still have to classify intent, cluster related threads, score demand, and track provenance. Demandex does that work and returns decision-ready demand signals — opportunity cards and cold/warm/hot verdicts — priced per call. Every claim links back to the public Reddit post it came from.
How do agents pay for the demand data?
Paid routes settle per call via x402 in USDC on Base Mainnet. Call a paid route with no payment to get the 402 challenge, sign the exact-scheme USDC authorization, then retry with the PAYMENT-SIGNATURE (x402 V2) or X-PAYMENT (legacy) header. No signup, no API key. You are never charged for an error.
What can I ask about?
Physical products only. Use POST /v1/gauge or /v1/gauge/live to get a demand verdict for any product query, browse /v1/opportunities by category, or pull the full /v1/opportunity card with evidence. Demandex is informational — it is not a guarantee of any business outcome.