API Documentation

The Each Directory REST API provides programmatic access to our directory catalog. All responses are JSON.

Base URL

https://each.directory/api/v1

Endpoints

List Sites

GET /api/v1/sites

Returns paginated list of active directory listings. Supports ?page= and ?limit= query parameters.

Search

GET /api/v1/search?q=your+query

Search directories by name or description.

Categories

GET /api/v1/categories

List all categories with directory counts.

Category Detail

GET /api/v1/categories/:slug

Get a specific category with its directory listings.

Featured Sites

GET /api/v1/sites/featured

Returns featured directory listings.

Submit a Directory

POST /api/v1/submit

Submit a new directory for review. Requires: name, url, description, email.

Public Stats

GET /api/v1/stats

Returns public statistics about the directory catalog.

MCP Endpoint

AI agents can connect via the Model Context Protocol at POST /mcp (JSON-RPC 2.0).

Agent Card

Machine-readable agent metadata is available at /.well-known/agent-card.json.

Rate Limits

Free tier: 100 requests/hour. See pricing for higher limits.