API Reference

Integrate Content Pilot's SEO analysis and optimization features into your workflow.

Base URL

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

API Access

API access is available on Enterprise plans. Contact sales to enable API access for your account.

Authentication

All API requests require authentication via an API key passed in the Authorization header.

Request Header

Authorization: Bearer YOUR_API_KEY

Getting Your API Key

  1. Log in to your Content Pilot dashboard
  2. Go to Settings → API
  3. Click "Generate API Key"
  4. Copy and securely store your key

Rate Limits

API requests are rate-limited based on your plan:

Plan Requests/min Requests/day
Enterprise10010,000
Enterprise Plus50050,000

SERP Analysis

Analyze top-ranking pages for a keyword.

POST /analyze

Request Body

{
  "keyword": "content marketing strategies",
  "location": "United States",
  "language": "en"
}

Response

{
  "keyword": "content marketing strategies",
  "search_volume": 12000,
  "difficulty": 67,
  "recommendations": {
    "word_count": {
      "min": 1800,
      "max": 2500,
      "average": 2150
    },
    "headings": ["What is", "How to", "Best practices"],
    "nlp_keywords": [
      {"term": "content strategy", "importance": 0.95},
      {"term": "target audience", "importance": 0.87},
      {"term": "content calendar", "importance": 0.82}
    ]
  },
  "competitors": [
    {"url": "example.com/...", "word_count": 2340, "score": 89}
  ]
}

Content Score

Get an SEO score for your content against a target keyword.

POST /score

Request Body

{
  "keyword": "content marketing strategies",
  "content": "Your article content here...",
  "title": "10 Content Marketing Strategies"
}

Response

{
  "score": 78,
  "word_count": 1850,
  "recommendations": [
    {"type": "keyword", "message": "Add 'content calendar' 2 more times"},
    {"type": "heading", "message": "Add H2 about 'measuring results'"},
    {"type": "length", "message": "Consider adding 300 more words"}
  ],
  "keyword_usage": {
    "primary": {"count": 8, "recommended": 10},
    "nlp": [
      {"term": "content strategy", "count": 3, "recommended": 4}
    ]
  }
}

Content Briefs

Generate AI-powered content briefs for any keyword.

POST /briefs

Request Body

{
  "keyword": "how to start a blog",
  "tone": "professional",
  "target_audience": "beginners"
}

Error Handling

The API returns standard HTTP status codes and error messages.

Code Description
200Success
400Bad request - Invalid parameters
401Unauthorized - Invalid API key
429Rate limit exceeded
500Server error

SDKs & Libraries

Official SDKs for popular programming languages.

JS

JavaScript / Node.js

npm install content-pilot
PY

Python

pip install content-pilot

Need Help?

Our team is here to help you integrate Content Pilot into your workflow.

Contact Support