{"uid":"cap_izZApUgnpGdzcbycVF-Le","slug":"nohumans-directory-demand-clusters-d88a64f1","name":"nohumans.directory Demand Clusters","description":"nohumans.directory demand clusters: what agents searched this directory for over the last 30 days, grouped by meaning rather than exact wording, with searches and distinct-client counts per cluster. Self-monitoring sellers excluded, exclusion published; k-anonymity floor of 3 clients per cluster. The free tier at /v1/demand is the same shape, delayed. Money buys currency and the clustering — never raw queries or client identifiers.","url":"https://api.nohumans.directory/v1/demand/clusters?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"required":{"type":"string"},"properties":{"type":"string"}}},"responseSchema":{"type":"object","properties":{"note":{"type":"string"},"clusters":{"type":"array"},"window_days":{"type":"integer"},"generated_at":{"type":"integer"},"delay_seconds":{"type":"integer"},"window_ends_at":{"type":"integer"},"refresh_seconds":{"type":"integer"},"window_complete":{"type":"boolean"},"window_starts_at":{"type":"integer"},"scripted_rotation":{"type":"array"},"distinct_query_texts":{"type":"integer"},"named_listing_lookups":{"type":"array"},"excluded_short_queries":{"type":"integer"},"scripted_rotation_rule":{"type":"string"},"texts_pending_grouping":{"type":"integer"},"total_queries_analyzed":{"type":"integer"},"named_listing_lookup_rule":{"type":"string"},"scripted_rotation_searches":{"type":"integer"},"clusters_below_privacy_floor":{"type":"integer"},"named_listing_lookup_searches":{"type":"integer"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_UFeIa1bl83fKTUPuZQ8gn","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns clustered demand signals from the nohumans.directory — what AI agents have been searching for over the last 30 days, grouped by meaning with search and distinct-client counts per cluster, subject to k-anonymity privacy floors.","exampleAgentPrompt":"Pull the latest demand clusters from nohumans.directory — I want to see what AI agents have been searching for most over the past 30 days, grouped by meaning, so I can spot which API categories have the highest demand.","exampleUseCases":[{"title":"Market research for new API product","prompt":"I'm thinking of building a new paid API — can you check nohumans.directory's demand clusters to see what AI agents are actually searching for most, so I can figure out which capability gaps are worth filling?"},{"title":"Tracking agent economy search trends","prompt":"Pull this month's demand clusters from nohumans.directory and tell me which search intent groups have the most distinct agent clients — I want to see where the real demand is concentrated, not just total query volume."},{"title":"Competitor intelligence for API sellers","prompt":"I sell paid APIs on nohumans.directory — can you fetch the current demand clusters and highlight any meaningful categories where there's lots of agent interest but I'm not yet offering anything?"}],"resultDescription":"Returns an array of demand clusters, each representing a group of semantically similar searches made by AI agents on nohumans.directory in the last 30 days, along with a search count and distinct client count per cluster (k-anonymity floor of 3 clients enforced). Also includes metadata: window_days, delay_seconds (real-time vs delayed), total_queries_analyzed, distinct_query_texts, and clusters_below_privacy_floor.","failureModes":["Payment of $0.25 USDC not received — x402 payment required before data is returned","No clusters available yet (directory too new or all clusters below k-anonymity floor of 3)","Rate limiting or quota exhaustion on repeated calls","Network timeout if clustering computation is slow","Stale data if the real-time pipeline is delayed — delay_seconds field indicates lag"],"whenToPreferThis":"Choose this endpoint when you need aggregated, privacy-safe intelligence about what AI agents are actually searching for in a paid API marketplace, particularly within the x402 / nohumans.directory ecosystem. Prefer this over raw search logs (unavailable by design) or free-tier /v1/demand (delayed). Ideal for API sellers doing market research, builders evaluating which capabilities to develop, or analysts tracking trends in the autonomous agent economy.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:31:40.941Z","isFirstParty":false,"canonicalSlug":"nohumans-directory-demand-clusters-d88a64f1"}