// WHAT IS DEMANDEX

What is Demandex?

Demandex is a pay-per-call e-commerce demand-intelligence API for AI agents — the index of what people want next. It mines Reddit complaint and purchase-intent posts across 82 communities into scored, evidence-backed opportunity cards and answers ad-hoc demand verdicts for any physical-product query, priced by the call in USDC on Base via x402 with no signup and no API keys. It is built for agents, builders, and sellers hunting unmet demand — the gaps buyers complain about but cannot find a product for. Physical products only; it is informational, not a guarantee of any business outcome.

What you get

  • Free category index GET /v1/categories lists every active category with its opportunity count, top score, and last-updated time; a cheap change-detection funnel.
  • Free sample card GET /v1/sample/opportunity returns one real, provably-lagged opportunity card in the full paid shape so you can learn the contract before paying.
  • Trending & category lists /v1/opportunities/trending (top-20 teasers) and /v1/opportunities?category= (up to 50 cards in a category).
  • Full opportunity card /v1/opportunity returns all score components (frequency, intensity, willingness-to-pay), the product angle, summary, and verbatim evidence[] with subreddit, upvotes, and permalinks.
  • Demand verdicts POST /v1/gauge (7-day cached, corpus-only) and POST /v1/gauge/live (backed by a fresh Reddit search) score any query cold/warm/hot with top evidence and related opportunities.
  • Whole-job brief /v1/brief bundles trending signals, the top-scored opportunities, and the per-category landscape in a single call.
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.

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 the same request with the PAYMENT-SIGNATURE (x402 V2) or X-PAYMENT (legacy) header. Compute-first / settle-after means you are never charged for an error. Your first call:

curl -sS https://api.demandex.dev/v1/opportunities/trending

Alternatives

The do-it-yourself route is the raw Reddit API (or PRAW) plus your own scraping and manual mining. That gives you unrestricted access to posts and full control over which subreddits you watch — but you own the classification, clustering, scoring, deduplication, and provenance-tracking, and you spend the time turning a firehose of threads into anything decision-ready.

Demandex trades that control for classified demand signals across 82 communities delivered as scored opportunity cards with verbatim evidence, priced per call. The tradeoff is that you consume Demandex’s community roster and demand-pattern taxonomy rather than defining your own. Both are valid — raw Reddit access when you need bespoke mining, Demandex when you want the signal already scored and evidence-backed.

FAQ

What is Demandex?
Demandex is the index of what people want next — a pay-per-call e-commerce demand-intelligence API for AI agents. It mines Reddit complaint and purchase-intent posts across 82 communities, classifies them into demand patterns, clusters them into scored opportunity cards with verbatim evidence and permalinks, and answers ad-hoc demand verdicts for any physical-product query. Physical products only; informational, not a guarantee of any business outcome.
How do agents pay for Demandex?
Paid routes settle per call via x402 in USDC on Base Mainnet. Call a paid route with no payment to receive the x402 402 challenge, sign the exact-scheme USDC authorization for the Base rail, then retry with the PAYMENT-SIGNATURE (x402 V2) or X-PAYMENT (legacy) header. There is no signup and no API key. Compute-first / settle-after means you are never charged for an error.
Where does the evidence come from?
Every claim traces to a public Reddit post. Opportunity cards and demand verdicts carry verbatim evidence quotes with their subreddit, upvote counts, and permalinks, so you can verify each signal at its source. The mined corpus refreshes roughly every 30 minutes, and each priced response carries a fetchedAt timestamp.
Can I try it before paying?
Yes. GET /v1/categories returns the free category index — every active category with its opportunity count and top score — as a cheap change-detection funnel. GET /v1/sample/opportunity returns one real, provably-lagged opportunity card in the same full shape as the paid card, so you can learn the response contract before paying.

For agents

Everything is machine-readable — start at llms.txt. No docs portal, no sandbox keys, no signup.