# nohumans.directory Demand Report

> nohumans.directory Demand Report is a paid API for AI agents from api.nohumans.directory, paid per call via x402, $2/call, status unknown (last checked 2026-10-11).

Returns a ranked list of what AI agents have been searching for in the nohumans.directory registry over the past 30 days, including search volume, unique client IPs, and whether those needs were answered by existing listings.

## Facts

- Endpoint: GET https://api.nohumans.directory/v1/demand/report?utm_source=zero.xyz
- Price: $2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nohumans-directory-demand-report-991f407c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_B2WgMugxo87rjGX92sDoV

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability nohumans-directory-demand-report-991f407c
```

Example prompt: Pull the nohumans.directory demand report so I can see what AI agents have been searching for over the last 30 days — especially any needs that aren't being answered by verified listings.

## When to prefer this

Use this endpoint when you want aggregate demand intelligence across the entire nohumans.directory ecosystem — specifically to understand what searches agents are making, how frequently, and whether those needs are being met by verified listings. Prefer it over individual listing lookups when doing market research, ecosystem gap analysis, or deciding what paid APIs to build or list. It is distinct from sibling endpoints that return trust verdicts or purchase histories for specific listings.

## Known failure modes

- Payment not received (x402 payment required before data is returned)
- Invalid or malformed query parameters result in an error response
- No demand data available for the requested window or edition
- Rate limiting if too many requests from a single client without payment
- Stale data if the 30-day aggregation pipeline is delayed

## How this service works

Registry of paid x402 APIs and datasets for AI agents. Every listing is probed, many are bought with real USDC, and every outcome is published. Free API + MCP.

## Output

A JSON object containing an array of demand 'needs', each with the raw search query text agents used, total search count, number of distinct client IPs that searched, and a breakdown of how many listings were returned and how many were verified. Also includes report metadata: the edition, window duration in days, and delay in seconds.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "required": {
   "type": "string"
  },
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "needs": [
   {
    "need": "ecb reference rates",
    "searches": 44,
    "client_ips": 6,
    "answered_now": {
     "listings_returned": 2,
     "verified_listings": 0
    }
   }
  ],
  "report": "demand",
  "window": {
   "days": 30,
   "delay_seconds": 0
  },
  "edition": "everything"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nohumans-directory-demand-report-991f407c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.nohumans.directory](https://www.zero.xyz/host/api.nohumans.directory/llms.txt)