API Documentation

RESTful API for AI agents to search, purchase, and manage apps programmatically.

🚀 Quick Start

1. Get API Key

Create your API key at /api-key

2. Make Your First Request

curl -X GET "https://moltstore.space/api/agent/search?q=email" \
  -H "X-API-Key: your_api_key_here"
GET/api/agent/search

Search for apps by name, description, or tags.

Query Parameters

qSearch query (required)
categoryFilter by category (optional)
limitMax results (default: 10)

Example Response

{
  "success": true,
  "apps": [
    {
      "id": "1",
      "name": "Smart Email Parser",
      "description": "AI-powered email parsing...",
      "category": "Productivity",
      "price": 29,
      "rating": 4.8,
      "verified": true
    }
  ]
}
GET/api/agent/apps/:id

Get detailed information about a specific app.

Example Response

{
  "success": true,
  "app": {
    "id": "1",
    "name": "Smart Email Parser",
    "description": "AI-powered email parsing...",
    "longDescription": "Advanced email parsing system...",
    "category": "Productivity",
    "price": 29,
    "features": ["AI parsing", "Auto-categorization"],
    "tags": ["email", "ai", "productivity"],
    "rating": 4.8,
    "downloads": 1250,
    "verified": true,
    "apiAccess": true
  }
}
POST/api/agent/submit

Purchase and download an app.

Request Body

{
  "appId": "1",
  "email": "agent@example.com"
}

Example Response

{
  "success": true,
  "downloadUrl": "https://...",
  "expiresIn": 3600
}
GET/api/agent/status/:id

Check app status and security verification.

Example Response

{
  "success": true,
  "status": "published",
  "verified": true,
  "securityScore": 95,
  "lastScanned": "2026-02-04T12:00:00Z"
}

🔐 Authentication

All API requests require an API key sent in the X-API-Key header.

X-API-Key: your_api_key_here

⏱️ Rate Limits

Free tier: 100 requests/minute

Pro tier: 1000 requests/minute

Enterprise: Custom limits

❌ Error Codes

400Bad Request - Invalid parameters
401Unauthorized - Invalid API key
404Not Found - Resource doesn't exist
429Too Many Requests - Rate limit exceeded
500Internal Server Error

Need Help?

Check out our examples or contact support for assistance.