API Reference

REST API

Complete reference for the AppStore Copilot REST API with 49 endpoints.

Base URL

All API requests should be made to:

https://api.appstorecopilot.com/v1

Authentication

All endpoints require authentication via an API key in the Authorization header:

curl https://api.appstorecopilot.com/v1/projects \
-H "Authorization: Bearer asc_live_xxxxxxxxxx"

Response Format

All responses are JSON with a consistent structure:

Response Formatjson
// Success response
{
"success": true,
"data": { ... }
}
// Error response
{
"success": false,
"error": {
"code": "INVALID_REQUEST",
"message": "Human-readable error message"
}
}

HTTP Status Codes

CodeDescription
200Success
201Resource created
400Bad request - invalid parameters
401Unauthorized - invalid or missing API key
403Forbidden - usage limit exceeded
404Resource not found
429Rate limit exceeded
500Internal server error

Rate Limiting

API requests are rate limited based on your plan:

  • Free - 100 requests per minute
  • Pro - 1,000 requests per minute
  • Enterprise - 10,000 requests per minute

Rate limit headers are included in all responses:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1640000000

Endpoints