nohumans.directory Discover API

The Discover API from nohumans.directory — 1 operation(s) for discover.

GitHub OpenAPI

Operations 1

GET /v1/discover Search listings (verified ranked first, then relevance, probe score and… #

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-discover-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-discover-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Nohumans Directory Discover 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 Discover 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: Discover
paths:
  /v1/discover:
    get:
      summary: Search listings (verified ranked first, then relevance, probe score and…
      parameters:
      - name: q
        in: query
        schema:
          type: string
        description: 'Semantic query — describe the actual need in words; improves the directory''s demand data. Aliases: search, query'
      - name: category
        in: query
        schema:
          type: string
        example: data.fx
      - name: max_price
        in: query
        schema:
          type: number
      - name: min_score
        in: query
        schema:
          type: number
          minimum: 0
          maximum: 1
      - name: protocol
        in: query
        schema:
          type: string
          enum:
          - x402
          - mpp
        description: Only listings offering this payment protocol (as observed on the endpoint). Omit for any.
      - name: mpp_method
        in: query
        schema:
          type: string
        example: stripe
        description: Only listings offering this MPP method (as the endpoint names it). Implies protocol=mpp.
      - name: evidence
        in: query
        schema:
          type: string
          enum:
          - paid_verified
        description: 'Only listings bought with real USDC that delivered, with no settled purchase since that failed. Alias: paid_verified=true'
      - name: limit
        in: query
        schema:
          type: integer
          minimum: 1
          maximum: 50
          default: 10
      responses:
        '200':
          description: Ranked results
          content:
            application/json:
              schema:
                type: object
                properties:
                  count:
                    type: integer
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/ListingSummary'
        '400':
          description: 'invalid_parameter: a filter value is not valid (the body names it); nothing was searched'
      security: []
      tags:
      - Discover
      operationId: getV1Discover
      x-operation-id-source: derived
    servers:
    - url: https://api.nohumans.directory
    - url: https://nohumans.directory
components:
  schemas:
    ListingSummary:
      type: object
      additionalProperties: true
      properties:
        id:
          type: string
        name:
          type: string
        description:
          type: string
        endpoint_url:
          type: string
        category:
          type: string
        kind:
          type: string
          enum:
          - api
          - agent
        price_amount:
          type: number
        price_currency:
          type: string
        chains:
          type: array
          items:
            type: string
          description: Networks you can PAY on, as declared by the seller. Not the data or chains the service covers; observed_network is what the live 402 named.
        status:
          type: string
          enum:
          - verified
          - unverified
          - failing
        status_changed_at:
          type: integer
        has_sample:
          type: boolean
        onchain_scope:
          type:
          - string
          - 'null'
          description: 'What the on-chain figures describe, in words: this listing''s own payTo, or a wallet shared by N listings. Read before quoting them.'
        probes_passed:
          type:
          - integer
          - 'null'
        probes_failed:
          type:
          - integer
          - 'null'
        paid_verified_at:
          type:
          - integer
          - 'null'
          description: Latest delivered purchase by our scout (unix seconds); paid_verified_at_iso is the same instant as ISO 8601. One purchase is not a continuing guarantee.
        x402_version:
          type:
          - integer
          - 'null'
        onchain_unique_payers_30d:
          type:
          - integer
          - 'null'
          description: Distinct wallets that sent USDC to this listing's payTo on Base in the window, from our own index (since 2026-08-29). CEILING on customer count — every incoming USDC transfer counts; operator self-funding inflates it; see onchain_shape
        onchain_tx_count_30d:
          type:
          - integer
          - 'null'
        onchain_volume_usd_30d:
          type:
          - number
          - 'null'
        onchain_checked_at:
          type:
          - integer
          - 'null'
          description: Last successful read; null = read before 2026-08-28 (time not retained)
        onchain_source:
          type:
          - string
          - 'null'
          enum:
          - index
          - null
          description: '''index'' = our own Base USDC index, no ceiling; null = legacy third-party read (150-item cap possible)'
        onchain_count_capped:
          type: boolean
          description: 'Legacy rows only: tx_count is a floor'
        onchain_payto_shared_listings:
          type:
          - integer
          - 'null'
          description: Active listings declaring the same payTo — figures belong to the address; never sum across listings
        onchain_daily:
          type:
          - array
          - 'null'
          items:
            type: object
            properties:
              day:
                type: string
              tx:
                type: integer
              payers:
                type: integer
              usd:
                type: number
          description: Per-UTC-day series, today + 30 prior days (index rows only). A 30d sum hides cliffs.
        onchain_shape:
          type:
          - object
          - 'null'
          properties:
            sample_n:
              type: integer
            eip3009:
              type: integer
            plain:
              type: integer
            other:
              type: integer
            sampled_at:
              type: integer
          description: '25 most recent payments classified by calldata: eip3009 = transferWithAuthorization (x402 exact scheme); plain = ordinary transfer(); other = unclassified. USDC inflow is not x402 revenue; this tells them apart'
        score:
          type:
          - number
          - 'null'
        probe_count:
          type: integer
          description: Every counted probe, passes AND failures; see probes_passed.
        p50_latency_ms:
          type:
          - number
          - 'null'
          description: Median over the last 7 days, timeouts included; null under 5 probes. A running average before 2026-09-24.
        p95_latency_ms:
          type:
          - number
          - 'null'
        last_probed_at:
          type:
          - integer
          - 'null'
        paid_verified:
          type: boolean
        paid_verification_latest:
          type:
          - object
          - 'null'
          description: The MOST RECENT settled purchase, whatever it found — delivered true or false, with the failure reason and tx hash. paid_verification above reports the latest SUCCESS and may be older; read both. A record that can only improve is a claim, not a record.
          properties:
            at:
              type: integer
            delivered:
              type: boolean
            tx_hash:
              type: string
            amount_usdc:
              type: number
            failure_reason:
              type:
              - string
              - 'null'
            failure_kind:
              type: string
              enum:
              - any_buyer
              - quality
              - request_dependent
              description: 'On a purchase that did not deliver (since 2026-11-19): any_buyer = nothing usable could come back whatever was asked (5xx, a second 402, empty answer, dropped connection); quality = an answer came back but stale against the listing''s promise or not the declared shape; request_dependent = the request as made was refused or answered in an undeclared form. https://nohumans.directory/methodology#failure-kind-1119'
            note:
              type: string
        payto_sentinel:
          type: boolean
          description: 'The endpoint''s live challenge names a burn address (zero/dead) that cannot receive funds. A payment sent as instructed is destroyed and nothing is delivered. Independent of status: such a listing can pass every protocol check and still be unpayable. Read payto_note.'
        payto_unstable:
          type: boolean
          description: The endpoint served several different payment addresses across recent checks; there is no stable destination to trust. Verify the address in the challenge you receive immediately before paying.
        payto_note:
          type:
          - string
          - 'null'
          description: Plain-language warning when payto_sentinel or payto_unstable is set; null otherwise.
        paid_depth:
          type: object
          description: 'How much paid evidence stands behind this listing, as a rung earned by delivering when bought: none, paid_verified (once), 2x (twice, >=48h apart), held (twice, across a seller-caused change), Nwk (across N>=3 weeks), failed_rebuy (delivered, then failed the latest purchase). Money never buys a rung.'
          properties:
            rung:
              type: string
            deliveries:
              type: integer
            span_weeks:
              type: integer
            first_ok_at:
              type:
              - integer
              - 'null'
            last_ok_at:
              type:
              - integer
              - 'null'
            last_attempt_ok:
              type:
              - integer
              - 'null'
            through_change:
              type: boolean
        evidence_tier:
          type: string
          enum:
          - payer_reported
          - paid_verified
          - probe_verified
          - probe_only
          - unproven
        evidence_note:
          type: string
        verdict_age_seconds:
          type:
          - integer
          - 'null'
        payment_protocols:
          type: array
          items:
            type: string
            enum:
            - x402
            - mpp
          description: Protocols the endpoint's own 402 offered on our unpaid probes (since 2026-09-26). Paid verification and on-chain figures cover x402 on Base only.
        mpp_methods:
          type:
          - array
          - 'null'
          items:
            type: string
          description: 'MPP (WWW-Authenticate: Payment) methods as the endpoint names them; the record adds mpp_offers and mpp_note.'
  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'