API Integration

Build custom integrations with the Content Pilot REST API.

Authentication

All API requests require authentication via API key:

Authorization: Bearer YOUR_API_KEY

Generate API keys in Settings → API Keys. Keep your keys secure and never expose them in client-side code.

Base URL

https://api.content-pilot.cloud/v1

Endpoints

SERP Analysis

POST /analyze
{
  "keyword": "content marketing",
  "location": "US",
  "language": "en"
}

Get Analysis Results

GET /analysis/{analysis_id}

Content Score

POST /score
{
  "analysis_id": "abc123",
  "content": "Your article content here..."
}

Projects

GET /projects
POST /projects
GET /projects/{id}
DELETE /projects/{id}

Rate Limits

  • Starter: 100 requests/hour
  • Pro: 500 requests/hour
  • Enterprise: Custom limits

Error Handling

API errors return standard HTTP status codes:

  • 400 - Bad request (check parameters)
  • 401 - Unauthorized (check API key)
  • 403 - Forbidden (insufficient permissions)
  • 429 - Rate limit exceeded
  • 500 - Server error

Full API Reference

For complete documentation including all endpoints, parameters, and examples, see our API Reference.