{"version":"1","source":"Harpd","documentation":"https://harpd.com/developers/agents/","products":[{"product":"search","resource_id":"agent-search-v1","title":"Harpd AI product search","description":"Free keyword search over the published Harpd AI product catalog, with category filters and stable machine-readable results.","endpoint":"https://api.harpd.com/api/agent/v1/search","method":"GET","pricing_mode":"free","price":"0","currency":"USD","payment_protocols":[],"input_schema":{"type":"object","properties":{"q":{"type":"string","minLength":2,"maxLength":200},"category":{"type":"string"},"limit":{"type":"integer","minimum":1,"maximum":50,"default":10}},"required":["q"],"additionalProperties":false},"output_schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["query","count","results"],"properties":{"query":{"type":"string"},"count":{"type":"integer"},"results":{"type":"array"}}},"meta":{"type":"object"}}},"canonical":"https://harpd.com/products/","dataset":"https://harpd.com/data/products.json","methodology":"https://harpd.com/rank/methodology/"},{"product":"rank","resource_id":"agent-rank-v1","title":"Harpd AI product rankings","description":"Free Harpd Rank board for any scope and category, in the unified agent envelope.","endpoint":"https://api.harpd.com/api/agent/v1/rank","method":"GET","pricing_mode":"free","price":"0","currency":"USD","payment_protocols":[],"input_schema":{"type":"object","properties":{"scope":{"type":"string","enum":["overall","monthly","weekly"],"default":"overall"},"category":{"type":"string","default":"all"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":50}},"additionalProperties":false},"output_schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object"},"meta":{"type":"object"}}},"canonical":"https://harpd.com/rank/","dataset":"https://harpd.com/data/rank.json","methodology":"https://harpd.com/rank/methodology/"},{"product":"pricing","resource_id":"agent-pricing-v1","title":"Harpd Agent API pricing manifest","description":"Machine-readable price list for every Harpd Agent API product. The same numbers appear in the 402 challenge and the developer docs.","endpoint":"https://api.harpd.com/api/agent/v1/pricing","method":"GET","pricing_mode":"free","price":"0","currency":"USD","payment_protocols":[],"input_schema":{"type":"object","additionalProperties":false},"output_schema":{"type":"object","required":["data","meta"]},"canonical":"https://harpd.com/developers/agents/","dataset":"https://harpd.com/data/rank.json","methodology":"https://harpd.com/rank/methodology/"},{"product":"compare","resource_id":"agent-compare-v1","title":"Harpd AI product comparison","description":"Head-to-head comparison of 2–8 AI products: category, published rank, list pricing where the product is a priced model, and the material differences between them.","endpoint":"https://api.harpd.com/api/agent/v1/compare","method":"POST","pricing_mode":"per_request","price":"0.01","currency":"USDC","payment_protocols":["x402"],"input_schema":{"type":"object","properties":{"products":{"type":"array","minItems":2,"maxItems":8,"items":{"type":"string"}}},"required":["products"],"additionalProperties":false},"output_schema":{"type":"object","required":["data","meta"]},"canonical":"https://harpd.com/compare/","dataset":"https://harpd.com/data/products.json","methodology":"https://harpd.com/rank/methodology/"},{"product":"optimize_model","resource_id":"agent-optimize-model-v1","title":"Harpd AI model cost optimization","description":"Given a task and the model currently running it, returns cheaper candidate models that still clear the task quality floor, with per-call and projected monthly savings, the performance trade-off, a confidence value and the evidence behind every number.","endpoint":"https://api.harpd.com/api/agent/v1/optimize-model","method":"POST","pricing_mode":"per_request","price":"0.05","currency":"USDC","payment_protocols":["x402"],"input_schema":{"type":"object","properties":{"task":{"type":"string","minLength":3,"maxLength":2000},"current_model":{"type":"string"},"max_cost":{"type":"number","exclusiveMinimum":0},"monthly_calls":{"type":"integer","minimum":1,"maximum":100000000},"constraints":{"type":"object","properties":{"min_context_window":{"type":"integer","minimum":1000},"min_tier":{"type":"string","enum":["mini","fast","open","reasoning","flagship"]},"providers":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"required":["task","current_model"],"additionalProperties":false},"output_schema":{"type":"object","required":["data","meta"]},"canonical":"https://harpd.com/llm-cost-optimization/","dataset":"https://harpd.com/data/llm-pricing.json","methodology":"https://harpd.com/methodology/cost-per-successful-task/"},{"product":"research","resource_id":"agent-research-v1","title":"Harpd AI product research","description":"A structured research answer over the Harpd catalog: matching products, category distribution, price bands, evidence per claim and the sources behind them.","endpoint":"https://api.harpd.com/api/agent/v1/research","method":"POST","pricing_mode":"per_request","price":"0.05","currency":"USDC","payment_protocols":["x402"],"input_schema":{"type":"object","properties":{"query":{"type":"string","minLength":3,"maxLength":500},"limit":{"type":"integer","minimum":1,"maximum":50,"default":15}},"required":["query"],"additionalProperties":false},"output_schema":{"type":"object","required":["data","meta"]},"canonical":"https://harpd.com/research/","dataset":"https://harpd.com/data/research.json","methodology":"https://harpd.com/rank/methodology/"},{"product":"dataset_query","resource_id":"agent-dataset-v1","title":"Harpd structured dataset query","description":"Field-selective, filtered queries against the published Harpd datasets (ai-products, model-pricing) with row and field projection.","endpoint":"https://api.harpd.com/api/agent/v1/dataset/query","method":"POST","pricing_mode":"per_request","price":"0.02","currency":"USDC","payment_protocols":["x402"],"input_schema":{"type":"object","properties":{"dataset":{"type":"string","enum":["ai-products","model-pricing"]},"filters":{"type":"object"},"fields":{"type":"array","items":{"type":"string"}},"limit":{"type":"integer","minimum":1,"maximum":500,"default":50}},"required":["dataset"],"additionalProperties":false},"output_schema":{"type":"object","required":["data","meta"]},"canonical":"https://harpd.com/data/","dataset":"https://harpd.com/data/products.json","methodology":"https://harpd.com/rank/methodology/"},{"product":"history","resource_id":"agent-history-v1","title":"Harpd historical rank intelligence","description":"The rank history of one AI product over 3, 6 or 12 months: position over time, rank movement, best and worst position, and the archived period results. This is the one thing a single page view of the board cannot tell an agent — whether a position is rising or falling.","endpoint":"https://api.harpd.com/api/agent/v1/history","method":"POST","pricing_mode":"per_request","price":"0.05","currency":"USDC","payment_protocols":["x402"],"input_schema":{"type":"object","properties":{"product":{"type":"string","minLength":1,"maxLength":120,"description":"Harpd product slug, e.g. \"claude\"."},"period":{"type":"string","enum":["3m","6m","12m"],"default":"12m"},"scope":{"type":"string","enum":["overall","monthly","weekly"],"default":"overall"},"category":{"type":"string","default":"all"}},"required":["product"],"additionalProperties":false},"output_schema":{"type":"object","required":["data","meta"]},"canonical":"https://harpd.com/rank/","dataset":"https://harpd.com/data/rank.json","methodology":"https://harpd.com/rank/methodology/"},{"product":"test_paid","resource_id":"agent-test-paid-v1","title":"Harpd testnet payment smoke test","description":"A deliberately trivial paid product that exists so an agent can prove its whole x402 payment path — 402 challenge, signing, settlement, receipt — before it spends anything on data. Costs $0.01 and returns the request it received plus the settlement receipt.","endpoint":"https://api.harpd.com/api/agent/v1/test-paid","method":"POST","pricing_mode":"per_request","price":"0.01","currency":"USDC","payment_protocols":["x402"],"input_schema":{"type":"object","properties":{"echo":{"type":"string","maxLength":200,"description":"Any string; returned unchanged so the caller can correlate the round trip."}},"additionalProperties":false},"output_schema":{"type":"object","required":["data","meta"]},"canonical":"https://harpd.com/developers/agents/","dataset":"https://harpd.com/data/rank.json","methodology":"https://harpd.com/rank/methodology/"}]}