Harpd Agent API
The Agent API from Harpd — 6 operation(s) for agent.
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/harpd-com:harpd-com-agent-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. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Harpd Market Agent API
version: '2026-08-27'
description: Public machine discovery and free Harpd Rank resources. Paid machine access is disabled by default and requires an explicitly configured testnet or production payment mode.
x-guidance: 'For autonomous agents: call GET /api/agent/v1/rankings or /api/agent/v1/products/{slug} (free) to inspect Harpd Rank data. The paid GET /api/agent/v1/premium/rank-intelligence returns full Rank Intelligence (positions, movement, history, category summaries, #100 threshold) for 0.1 USDC on Base mainnet via x402, with no API key; the agent signs and settles USDC itself. Machine entry point: /.well-known/agent.json'
contact:
name: Harpd Support
email: harpdsupport@gmail.com
servers:
- url: https://api.harpd.com
tags:
- name: Agent
paths:
/api/agent/v1/catalog:
get:
operationId: getAgentCatalog
security: []
responses:
'200':
description: Machine-readable catalog
tags:
- Agent
summary: Get agent catalog
x-summary-source: derived
/api/agent/v1/rankings:
get:
operationId: getAgentRankings
security: []
parameters:
- name: scope
in: query
schema:
type: string
enum:
- overall
- monthly
- weekly
- name: category
in: query
schema:
type: string
responses:
'200':
description: Free Harpd Rank data
tags:
- Agent
summary: Get agent rankings
x-summary-source: derived
/api/agent/v1/products/{slug}:
get:
operationId: getAgentProduct
security: []
parameters:
- name: slug
in: path
required: true
schema:
type: string
responses:
'200':
description: Free product profile
'404':
description: Not found
tags:
- Agent
summary: Get agent product
x-summary-source: derived
/api/agent/v1/premium/demo:
get:
operationId: getPremiumDemo
security: []
responses:
'200':
description: Paid demo result
'402':
description: Payment required
'404':
description: Disabled in this environment
'503':
description: Payment mode or facilitator is not fully configured
tags:
- Agent
summary: Get premium demo
x-summary-source: derived
/api/agent/v1/premium/rank-intelligence:
get:
operationId: getRankIntelligence
security: []
x-payment-info:
price:
mode: fixed
currency: USD
amount: '0.100000'
protocols:
- x402: {}
parameters:
- name: scope
in: query
schema:
type: string
enum:
- overall
- monthly
- weekly
default: weekly
- name: category
in: query
schema:
type: string
enum:
- all
- seo
- agents
- ai-media
- marketing
- developer
- productivity
- people
- design
- social
- writing
- sales
- business
- games
- education
- health
- ecommerce
- directories
- hiring
- audio
- crypto
- agencies
- security
- travel
- news
- domains
- leaderboards
- real-estate
- other
default: all
- name: history_days
in: query
schema:
type: integer
minimum: 1
maximum: 90
default: 30
responses:
'200':
description: Paid Rank intelligence
content:
application/json:
schema:
$ref: '#/components/schemas/RankIntelligenceResponse'
'400':
description: Invalid input
'402':
description: Payment required with x402 Bazaar discovery metadata
'409':
description: Payment replay rejected
'503':
description: Payment or resource dependency unavailable
tags:
- Agent
summary: Get rank intelligence
x-summary-source: derived
/v1/agent/test:
get:
operationId: getAgentTestResource
security: []
responses:
'200':
description: Paid demo result
'402':
description: Payment required
tags:
- Agent
summary: Get agent test resource
x-summary-source: derived
components:
schemas:
RankIntelligenceResponse:
type: object
required:
- request_id
- resource
- generated_at
- scope
- category
- summary
- products
- methodology
properties:
request_id:
type: string
resource:
const: rank-intelligence-v1
generated_at:
type: string
format: date-time
scope:
type: string
enum:
- overall
- monthly
- weekly
category:
type: string
summary:
type: object
properties:
eligible_products:
type: integer
returned_products:
type: integer
maximum: 100
top_100_threshold_rp:
type: integer
approved_in_period:
type: integer
required:
- eligible_products
- returned_products
- top_100_threshold_rp
- approved_in_period
products:
type: array
maxItems: 100
items:
type: object
properties:
slug:
type: string
title:
type: string
category:
type: string
position:
type: integer
previous_position:
type:
- integer
- 'null'
movement:
type: string
rank_points:
type: integer
promotional_rank_points:
type: integer
history:
type: array
required:
- slug
- title
- category
- position
- movement
- rank_points
- promotional_rank_points
- history
methodology:
type: object