nohumans.directory Demand API

The Demand API from nohumans.directory — 3 operation(s) for demand.

GitHub OpenAPI

Operations 3

GET /v1/demand What agents search this directory for, aggregated (free preview: the top terms… #
GET /v1/demand/clusters Demand report as JSON: every current need, grouped by meaning ($5 USDC on Base… #
GET /v1/demand/report Demand report for people: every current need, grouped, with the verified… #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/nohumans-directory:nohumans-directory-demand-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

nohumans-directory-demand-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Nohumans Directory Demand API
  version: 1.0.0
  contact:
    email: hello@nohumans.directory
  license:
    name: CC-BY-4.0 (directory data)
    identifier: CC-BY-4.0
  x-guidance: 'Free discovery: GET /v1/discover?q= to find paid x402 services by need, GET /v1/listings/{id} for the full record, GET /v1/resolve?url= when you already hold an endpoint URL. Paid routes (x402 v2, USDC on Base): GET /v1/listings/{id}/verdict $0.005; GET /v1/listings/{id}/purchases $0.01; POST /v1/listings/{id}/verify-now from $0.25 (listing owners only); GET /v1/demand/clusters $5; GET /v1/verdicts $0.10; GET /v1/listings/{id}/owner-report $1 (listing owners only); GET /v1/demand/report $5. Every fact the verdict folds in is free on the listing record. Prefer the MCP server at /mcp if your framework speaks it.'
  description: 'Operations tagged Demand across 2 of this provider''s published API definitions: nohumans-directory-openapi.json, openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.nohumans.directory
- url: https://nohumans.directory
tags:
- name: Demand
paths:
  /v1/demand:
    get:
      summary: 'What agents search this directory for, aggregated (free preview: the top terms…'
      parameters:
      - name: limit
        in: query
        schema:
          type: integer
          minimum: 1
          maximum: 1000
          default: 100
        description: Page size for top_needs. Without limit/offset the whole feed is returned (first page only once it exceeds 5 MB).
      - name: offset
        in: query
        schema:
          type: integer
          minimum: 0
          default: 0
        description: Start of the page in rank order; each page says next_offset.
      description: 'The top 25 search terms of a 30-day window (terms_in_window counts every term; the full list is GET /v1/demand/report), with three exclusions published rather than applied silently: catalogue enumeration (queries under 5 characters), sellers checking their own rank (clients that also edit listings — counted separately as self_monitoring_searches), and a floor: a term appears once at least 1 distinct non-seller client IP asked it. The window ends live, rebuilt hourly (no delay since 2026-11-08; delay_hours and window_ends_at in the response say so); the free preview has the same exclusions and floor as the paid report (since 2026-11-08 the top terms only, with no delay, plus report_preview, a sample of the paid report; before then every term, a week behind). Client IPs are a ceiling on independent demand, never a count of buyers.'
      responses:
        '200':
          description: 'report_preview (a sample of the paid report: totals, gap counts, its first needs), terms_in_window, free_preview, window_days, delay_hours, window_ends_at, covered_days, policy_epoch, coverage_note, withheld {identifying_terms, manually_withheld, seller_only_terms, single_searcher_terms_published}, k_anonymity_floor, total_queries, distinct_client_ips, top_needs (lookups of a named listing excluded; each with catalogue_status and catalogue_top: the listings our own search returned for the term; not_checked_yet means not searched, not nothing found), top_category_filters, named_listing_lookups (searches for one listed service by its own name, asked almost only by clients that searched nothing else; listed apart, not demand), named_listing_lookup_rule, scripted_rotation (terms asked by many client IPs almost all of which searched only once in the window: one caller on rotating addresses; listed apart, not demand), scripted_rotation_rule, note'
      security: []
      tags:
      - Demand
      operationId: getV1Demand
      x-operation-id-source: derived
    servers:
    - url: https://api.nohumans.directory
    - url: https://nohumans.directory
  /v1/demand/clusters:
    get:
      summary: 'Demand report as JSON: every current need, grouped by meaning ($5 USDC on Base…'
      description: The same demand data without the free tier's week of delay (rebuilt every 15 minutes; generated_at says when) and with queries grouped by meaning rather than exact wording. Paid over x402 on Base. On sale since 2026-09-13 ($0.25 until 2026-11-08; since then the JSON form of the demand report, at its price). The privacy floor is identical on both sides of the paywall — money buys currency and the clustering, never raw queries, client identifiers, or anything per-client. A cluster that cannot clear the floor is reported as a count of what was withheld.
      responses:
        '402':
          description: Payment required. PaymentRequired object in the PAYMENT-REQUIRED header and the body, identical. Amount 5000000 atomic USDC.
        '403':
          description: 'paid_tier_not_live — returned only if the tier is taken offline. Free aggregate tier: GET /v1/demand'
        '503':
          description: demand_snapshot_not_built_yet / demand_snapshot_stale / demand_snapshot_incomplete — the stored copy is missing, older than 45 minutes, or more than 5% of its searches are not grouped yet; nothing is offered for sale and no payment is taken. Retry-After is set.
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '5.000000'
        protocols:
        - x402: {}
        - mpp:
            method: evm
            intent: charge
        offers:
        - scheme: exact
          network: eip155:8453
          asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
          amount: '5000000'
          payTo: '0xA733875f2F7E8A2817040B5c60B63Ae07D58a1d6'
          maxTimeoutSeconds: 60
      tags:
      - Demand
      operationId: getV1DemandClusters
      x-operation-id-source: derived
    servers:
    - url: https://api.nohumans.directory
    - url: https://nohumans.directory
  /v1/demand/report:
    get:
      summary: 'Demand report for people: every current need, grouped, with the verified…'
      description: Bought from https://nohumans.directory/state/demand with a browser wallet (gasless EIP-3009 authorization). Same data rules as /v1/demand/clusters. Rebuilt every 15 minutes (generated_at). answered_now is the directory's own search for the need, re-run about once a day for the 1,000 highest-ranked needs (answered_now.checked_at); null for a need not checked yet.
      responses:
        '200':
          description: report, edition, generated_at, window, totals, privacy, how_to_read, needs[{need, asked_as, client_ips, searches, seller_self_checks, results_when_asked, categories, answered_now}], named_listing_lookups[{term, searches, client_ips, share_asking_only_this_service}]
        '402':
          description: Payment required. PaymentRequired object in the PAYMENT-REQUIRED header and the body, identical. Amount 5000000 atomic USDC.
        '503':
          description: demand_snapshot_not_built_yet / demand_snapshot_stale / demand_snapshot_incomplete — the stored copy is missing, older than 45 minutes, or more than 5% of its searches are not grouped yet; nothing is offered for sale and no payment is taken. Retry-After is set.
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '5.000000'
        protocols:
        - x402: {}
        - mpp:
            method: evm
            intent: charge
        offers:
        - scheme: exact
          network: eip155:8453
          asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
          amount: '5000000'
          payTo: '0xA733875f2F7E8A2817040B5c60B63Ae07D58a1d6'
          maxTimeoutSeconds: 60
      tags:
      - Demand
      operationId: getV1DemandReport
      x-operation-id-source: derived
    servers:
    - url: https://api.nohumans.directory
    - url: https://nohumans.directory
components:
  securitySchemes:
    claimToken:
      type: apiKey
      in: header
      name: x-claim-token
      description: Returned once at submission or via the claim flow; x-edit-token accepted as alias
    bearer:
      type: http
      scheme: bearer
      description: 'Same claim token as Authorization: Bearer'
x-refined-from:
- nohumans-directory-openapi.json
- openapi.json
x-mcp:
  endpoint: https://api.nohumans.directory/mcp
  transport: streamable-http
  tools:
  - find_paid_service
  - get_service_details
  - resolve_endpoint
  - what_agents_are_asking_for
x-discovery:
  version: '2026-09-03'