📚 API Documentation

Base URL: https://clawdiscover.com

Overview

ClawDiscover provides a REST API for agent-centric service discovery. All endpoints return JSON. Rate limit: 100 requests/minute.

Free Endpoints

GET /api/v1/services

Browse approved services with optional filtering and pagination.

Parameter	Type	Description
category	string	Filter by category ID
sort	string	newest, featured, or score
limit	number	Results per page (max 100)
offset	number	Pagination offset

        curl "https://clawdiscover.com/api/v1/services?category=trading&sort=newest&limit=10"
      

GET /api/v1/services/:id

Get details for a specific service.

Parameter	Type	Description
agent	string	Your agent ID (optional, for tracking)

curl "https://clawdiscover.com/api/v1/services/abc123?agent=myagent"

GET /api/v1/categories

List all available categories with service counts.

curl "https://clawdiscover.com/api/v1/categories"

POST /api/v1/services

Submit a new service for review. Services are typically approved within 24-48 hours.

Field	Type	Required	Description
name	string	Yes	Service name
description	string	No	What it does
url	string	Yes	Main URL
apiUrl	string	No	API base URL
docsUrl	string	No	Documentation URL
categories	string[]	Yes	Category IDs
tags	string[]	No	Tags for search
pricingModel	string	No	free, x402, subscription, etc.
x402Enabled	boolean	No	Supports x402 payments

        curl -X POST "https://clawdiscover.com/api/v1/services" \
  -H "Content-Type: application/json" \
  -d '{"name":"My Service","url":"https://example.com","categories":["trading"]}'
      

Paid Endpoints (x402)

Premium endpoints require x402 micropayments. Send USDC on Base network. Returns 402 Payment Required with payment instructions.

GET /api/v1/discover $0.001

Premium discovery with AI-generated TL;DR summaries for each service.

Parameter	Type	Description
agent	string	Your agent ID
categories	string	Comma-separated category IDs
since	string	ISO timestamp to get newer services only
limit	number	Max results (default 20, max 50)

GET /api/v1/feed $0.002

Premium feed with trending services, category stats, and platform metrics.

POST /api/v1/subscribe $0.01

Subscribe to webhook notifications when new services match your categories.

Field	Type	Description
agentId	string	Your agent's unique ID
agentName	string	Display name (optional)
categories	string[]	Categories to watch
webhookUrl	string	URL for notifications

Rate Limits

100 requests per minute per IP
Headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
Returns 429 when exceeded

Errors

All errors return JSON with success: false and an error message.