{
  "openapi": "3.1.0",
  "info": {
    "title": "Harpd Agent Market API",
    "version": "2026-08-26",
    "description": "Machine discovery over Harpd Rank. Rankings and product profiles are free and unauthenticated (CC BY 4.0). Paid machine access is live on Base mainnet: premium resources return HTTP 402 with x402 payment requirements and settle in USDC. No API key is required - the agent pays and retries.",
    "x-guidance": "Agents: call GET /api/agent/v1/rankings and /api/agent/v1/products/{slug} for free. Premium resources (GET /api/agent/v1/premium/rank-intelligence) return HTTP 402 with x402 payment requirements; settle 0.1 USDC on Base (eip155:8453) and retry to receive the payload. No API key, no account, no registration.",
    "contact": { "name": "Harpd Support", "email": "harpdsupport@gmail.com" },
    "x-entity": {
      "name": "Harpd",
      "preferredWrittenBrand": "Harpd.com",
      "canonicalUrl": "https://harpd.com/",
      "organizationId": "https://harpd.com/#organization",
      "description": "Harpd is an independent product discovery and ranking intelligence platform for AI tools and software, publishing rankings, comparisons, research, datasets, benchmarks and evidence."
    },
    "x-public-resources": {
      "entityDefinition": "https://harpd.com/about/harpd/",
      "llmsTxt": "https://harpd.com/llms.txt",
      "llmsFullTxt": "https://harpd.com/llms-full.txt",
      "agentJson": "https://harpd.com/.well-known/agent.json",
      "agentCapabilityManifest": "https://harpd.com/.well-known/harpd-agent.json",
      "agentApiOpenApi": "https://harpd.com/developers/agents/openapi.json",
      "agentApiOpenApiYaml": "https://harpd.com/developers/agents/openapi.yaml",
      "agentApiDocs": "https://harpd.com/developers/agents/",
      "agentApiPricing": "https://api.harpd.com/api/agent/v1/pricing",
      "agentMcp": "https://api.harpd.com/mcp",
      "agentTrust": "https://harpd.com/for-agents/trust/",
      "brandPackage": "https://harpd.com/press/brand.json",
      "citationFormats": "https://harpd.com/citation/",
      "openData": "https://harpd.com/data/",
      "methodology": "https://harpd.com/rank/methodology/",
      "research": "https://harpd.com/research/",
      "categories": "https://harpd.com/categories/",
      "sitemap": "https://harpd.com/sitemap.xml"
    }
  },
  "externalDocs": {
    "description": "Harpd.com — canonical entity definition, datasets and citation formats",
    "url": "https://harpd.com/about/harpd/"
  },
  "servers": [
    { "url": "https://api.harpd.com" }
  ],
  "paths": {
    "/api/agent/v1/catalog": {
      "get": {
        "operationId": "getAgentCatalog",
        "responses": { "200": { "description": "Machine-readable catalog" } }
      }
    },
    "/api/agent/v1/rankings": {
      "get": {
        "operationId": "getAgentRankings",
        "responses": { "200": { "description": "Free Harpd Rank data" } }
      }
    },
    "/api/agent/v1/products/{slug}": {
      "get": {
        "operationId": "getAgentProduct",
        "responses": {
          "200": { "description": "Free product profile" },
          "404": { "description": "Not found" }
        }
      }
    },
    "/api/agent/v1/premium/rank-intelligence": {
      "get": {
        "operationId": "getRankIntelligence",
        "summary": "Harpd Rank Intelligence (paid)",
        "description": "Current Top 100 Rank intelligence with deterministic positions, daily movement, immutable period history, category summaries, Rank Point provenance, and the current Top 100 threshold.",
        "security": [],
        "x-payment-info": {
          "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" },
          "protocols": [{ "x402": {} }]
        },
        "responses": {
          "200": { "description": "Rank Intelligence payload" },
          "402": { "description": "Payment required with x402 Bazaar discovery metadata" }
        }
      }
    },
    "/api/agent/v1/premium/demo": {
      "get": {
        "operationId": "getPremiumDemo",
        "summary": "x402 handshake demo (paid)",
        "description": "A paid-resource handshake demonstrating HTTP 402, USDC settlement, and replay-safe fulfillment. Contains no premium dataset - use /api/agent/v1/premium/rank-intelligence for real paid data.",
        "security": [],
        "x-payment-info": {
          "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" },
          "protocols": [{ "x402": {} }]
        },
        "responses": {
          "200": { "description": "Paid demo result" },
          "402": { "description": "Payment required with x402 Bazaar discovery metadata" }
        }
      }
    },
    "/v1/agent/test": {
      "get": {
        "operationId": "getAgentTestResource",
        "security": [],
        "x-payment-info": {
          "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" },
          "protocols": [{ "x402": {} }]
        },
        "responses": {
          "200": { "description": "Paid demo result" },
          "402": { "description": "Payment required" }
        }
      }
    },
    "/v1/payments/config": {
      "get": {
        "operationId": "getPaymentConfig",
        "responses": { "200": { "description": "Public payment configuration" } }
      }
    },
    "/v1/payments/health": {
      "get": {
        "operationId": "getPaymentHealth",
        "responses": { "200": { "description": "Non-sensitive payment health" } }
      }
    }
  }
}