/
Directory Explore Trending New Collections Blog Guides Register API

Keyboard Shortcuts

Focus search/
Go to Directoryg d
Go to Trendingg t
Go to Exploreg e
Go to Homeg h
Close modal / blur searchEsc
Show this help?
Press ? anytime to toggle this panel

Fushu API

Build agent-powered apps with the Fushu API

https://fushu.dev/api/v1
v0.2.0 2,318+ Agents REST / JSON

Quick Start

Get up and running in seconds. No API key required for read endpoints.

Health Check 
# Check if the API is up
curl https://fushu.dev/api/v1/health

# Response
{"status": "ok", "agents_indexed": 2318, "version": "0.2.0"}
Search Agents 
# Search for agents by keyword
curl -X POST https://fushu.dev/api/v1/agents/search \
  -H "Content-Type: application/json" \
  -d '{"query": "code review", "limit": 5}'
Get Agent 
# Fetch a single agent by ID
curl https://fushu.dev/api/v1/agents/YOUR_AGENT_ID

Endpoint Reference

All endpoints return JSON. Base URL: https://fushu.dev/api/v1

🔍 Discovery

POST /api/v1/agents/search Agent-native search with structured filters (query, type, min_trust, capabilities)
GET /api/v1/agents/search Search agents by name, description, capabilities, or author
GET /api/v1/agents List agents with pagination, type filtering, and sorting
GET /api/v1/agents/bulk Bulk lookup — fetch up to 50 agent profiles in one call
GET /api/v1/agents/{id} Get a single agent profile by ID

👥 Social

POST /api/v1/agents/{id}/reviews Rate an agent (1-5) with optional comment and reviewer name
GET /api/v1/agents/{id}/connections Get related agents by shared categories, author, or capabilities

⚙ Platform

GET /api/v1/health Health check — verify the API is up and get version info
GET /api/v1/stats Directory statistics — agent counts, types, categories
POST /api/v1/submit Submit a new agent for directory review
POST /api/v1/claims Claim ownership of an agent listing
POST /api/v1/claims/{id}/verify Verify a pending ownership claim

📰 Content

POST /api/v1/newsletter Subscribe an email to the Fushu newsletter
GET /api/v1/marketing/posts Get generated marketing content, filterable by status and tone
GET /api/v1/marketing/ab-tests Get A/B test results for marketing content
GET /api/v1/marketing/metrics Get marketing metrics — tone distribution, publish counts

Rate Limits

Fair usage limits to keep the API fast for everyone.

Unauthenticated

100 req/min

Read-only endpoints. No API key needed for search, list, and profile lookups.

Write Endpoints

20 req/min

Reviews, submissions, claims, and newsletter signup are rate-limited per IP.

Bulk Lookups

50 IDs/call

Fetch up to 50 agent profiles per request via the bulk endpoint.

Ready to explore?

Try the interactive API explorer powered by OpenAPI, or browse the agent directory.

Open API Explorer Browse Directory