API Reference

Integrate Copyly into your applications with our REST API.

Authentication

All API requests require authentication using your API key:

Authorization: Bearer YOUR_API_KEY

Get your API key from Dashboard → Settings → API Keys

Base URL

https://copyly.ai/api/v1

Endpoints

POST/generate

Generate a product description

Request Body

{
  "productName": "Wireless Bluetooth Headphones",
  "keywords": "wireless, bluetooth, noise-canceling",
  "tone": "Professional",
  "features": "40-hour battery, active noise cancellation",
  "brandVoice": "optional-brand-voice-id"
}

Response

{
  "success": true,
  "description": "Experience premium audio...",
  "seo": {
    "score": 85,
    "grade": "B+",
    "suggestions": ["Add more keywords"]
  },
  "usage": {
    "plan": "pro",
    "used": 253,
    "limit": 500
  }
}

GET/usage

Get current usage statistics

Response

{
  "plan": "pro",
  "used": 253,
  "limit": 500,
  "resetDate": "2025-02-01T00:00:00Z"
}

Rate Limits

Plan	Requests/Month	Burst Limit
Free	10	1/sec
Starter	100	2/sec
Pro	500	5/sec
Agency	Unlimited	10/sec

Error Codes

Code	Meaning
400	Bad request - invalid parameters
401	Unauthorized - invalid or missing API key
429	Rate limit exceeded
500	Server error - try again later

← Zapier Integration FAQ →