REST API Reference

Programmatic Access

Integrate Claude Code Market into your tools and workflows with our REST API. Search agents, download files, and submit new agents programmatically.

Base URL

api/v1

Format

JSON

Auth

Bearer

Authentication

Most endpoints are public. Authentication is required only for submitting agents and accessing user-specific data.

Public Endpoints

No authentication required for browsing and downloading agents.

→GET /api/v1/agents
→GET /api/v1/agents/:slug
→GET /api/v1/categories

Authenticated Endpoints

Include your API key in the Authorization header.

Authorization: Bearer YOUR_API_KEY

Rate Limits

Public endpoints: 100 requests/minute. Authenticated endpoints: 1000 requests/minute. Rate limit info is included in response headers.

Endpoints

Complete API endpoint reference with parameters and responses.

GET/api/v1/agents

List all agents with optional filtering and pagination

Parameters

categorystring

Filter by category slug

searchstring

Search agents by name or description

pageinteger

Page number (default: 1)

limitinteger

Items per page (default: 20, max: 100)

Response

{
  "data": [
    {
      "id": "123",
      "name": "Frontend Architect",
      "slug": "frontend-architect",
      "description": "Generate production-ready React components...",
      "category": "Frontend Development",
      "author": {
        "username": "devpro",
        "avatar_url": "https://..."
      },
      "stats": {
        "downloads": 3200,
        "avgRating": 4.8,
        "reviewCount": 156
      },
      "featured": true,
      "created_at": "2024-01-15T10:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 150,
    "totalPages": 8
  }
}

GET/api/v1/agents/{slug}

Get detailed information about a specific agent

Parameters

slugstringrequired

Agent slug identifier

Response

{
  "id": "123",
  "name": "Frontend Architect",
  "slug": "frontend-architect",
  "description": "Generate production-ready React components with TypeScript...",
  "longDescription": "Detailed markdown description...",
  "category": "Frontend Development",
  "tags": ["react", "typescript", "tailwind"],
  "author": {
    "username": "devpro",
    "avatar_url": "https://...",
    "bio": "Senior frontend developer..."
  },
  "stats": {
    "views": 12500,
    "downloads": 3200,
    "avgRating": 4.8,
    "reviewCount": 156
  },
  "installation": {
    "command": "curl -o frontend-architect.md ...",
    "directory": "~/.claude/agents/"
  },
  "featured": true,
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-20T14:22:00Z"
}

GET/api/v1/agents/{slug}/download

Download the agent markdown file (returns raw markdown content)

Parameters

slugstringrequired

Agent slug identifier

Response

# Frontend Architect Agent

You are a frontend architecture specialist...

## Capabilities
- React component generation
- TypeScript integration
- Tailwind CSS styling
...

GET/api/v1/categories

List all agent categories

Response

{
  "data": [
    {
      "id": "1",
      "name": "Frontend Development",
      "slug": "frontend-development",
      "description": "Build modern user interfaces",
      "agentCount": 45,
      "icon": "💻"
    },
    {
      "id": "2",
      "name": "Backend Development",
      "slug": "backend-development",
      "description": "Server-side APIs and services",
      "agentCount": 38,
      "icon": "⚙️"
    }
  ]
}

POST/api/v1/agentsAuth

Submit a new agent (requires authentication)

Parameters

namestringrequired

Agent name

descriptionstringrequired

Short description (max 200 chars)

categorystringrequired

Category slug

contentstringrequired

Agent markdown content

Response

{
  "id": "124",
  "name": "My New Agent",
  "slug": "my-new-agent",
  "status": "pending_review",
  "message": "Agent submitted successfully and is pending review"
}

Code Examples

Ready-to-use code snippets in your favorite language.

list Agents

curl -X GET "https://ccmarketplace.com/api/v1/agents?category=frontend&limit=10" \
  -H "Accept: application/json"

get Agent

curl -X GET "https://ccmarketplace.com/api/v1/agents/frontend-architect" \
  -H "Accept: application/json"

download Agent

curl -X GET "https://ccmarketplace.com/api/v1/agents/frontend-architect/download" \
  -o frontend-architect.md

create Agent

curl -X POST "https://ccmarketplace.com/api/v1/agents" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Agent",
    "description": "Agent description",
    "category": "frontend-development",
    "content": "# Agent markdown content..."
  }'

Status Codes

HTTP status codes returned by the API.

200OK

Request successful

201Created

Resource created successfully

400Bad Request

Invalid request parameters

401Unauthorized

Missing or invalid authentication

404Not Found

Resource not found

429Too Many Requests

Rate limit exceeded

500Internal Server Error

Server error occurred

Start building with the API

Get your API key and start integrating Claude Code Market into your workflow today.