Skip to main content
POST
/
v1
/
content
/
recommend
curl -X POST "https://api.agenticpencil.com/v1/content/recommend" \
  -H "Authorization: Bearer ap_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "sonant.ai",
    "focus_topics": ["ai receptionist", "insurance automation"],
    "brand_context": "AI receptionist for P&C insurance agencies",
    "competitors": ["smith.ai"],
    "country": "US",
    "limit": 5
  }'
import requests

response = requests.post(
    "https://api.agenticpencil.com/v1/content/recommend",
    headers={"Authorization": "Bearer ap_your_api_key_here"},
    json={
        "domain": "sonant.ai",
        "focus_topics": ["ai receptionist", "insurance automation"],
        "brand_context": "AI receptionist for P&C insurance agencies",
        "country": "US",
        "limit": 5
    }
)
const response = await fetch('https://api.agenticpencil.com/v1/content/recommend', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer ap_your_api_key_here',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    domain: 'sonant.ai',
    focus_topics: ['ai receptionist', 'insurance automation'],
    brand_context: 'AI receptionist for P&C insurance agencies',
    country: 'US',
    limit: 5
  })
});
{
  "success": true,
  "data": {
    "plan_id": "abc-123",
    "domain": "sonant.ai",
    "existing_keywords": 50,
    "sitemap_pages": 229,
    "recommendations": [
      {
        "priority": 1,
        "title": "Ai Receptionist: What You Need to Know",
        "target_keyword": "ai receptionist",
        "search_volume": 500,
        "keyword_difficulty": 30,
        "opportunity_score": 85,
        "search_intent": "informational",
        "outline": [
          { "h2": "What Is an AI Receptionist?", "talking_points": ["definition", "key features"] },
          { "h2": "Benefits for Insurance Agencies", "talking_points": ["24/7 availability", "cost savings"] },
          { "h2": "How to Choose the Right Solution", "talking_points": ["comparison criteria", "pricing"] }
        ],
        "related_keywords": ["virtual receptionist", "ai phone answering"]
      }
    ],
    "cannibalization": [
      {
        "keyword": "ai receptionist",
        "urls": ["/blog/ai-receptionist", "/features"],
        "recommendation": "Consolidate these pages or differentiate their target keywords"
      }
    ],
    "total_recommendations": 1
  },
  "meta": {
    "credits_used": 15,
    "credits_remaining": 985,
    "request_id": "abc-123"
  }
}
{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "domain is required"
  }
}
Generate strategic content recommendations with full outlines, cannibalization detection, and opportunity scoring.
curl -X POST "https://api.agenticpencil.com/v1/content/recommend" \
  -H "Authorization: Bearer ap_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "sonant.ai",
    "focus_topics": ["ai receptionist", "insurance automation"],
    "brand_context": "AI receptionist for P&C insurance agencies",
    "competitors": ["smith.ai"],
    "country": "US",
    "limit": 5
  }'
import requests

response = requests.post(
    "https://api.agenticpencil.com/v1/content/recommend",
    headers={"Authorization": "Bearer ap_your_api_key_here"},
    json={
        "domain": "sonant.ai",
        "focus_topics": ["ai receptionist", "insurance automation"],
        "brand_context": "AI receptionist for P&C insurance agencies",
        "country": "US",
        "limit": 5
    }
)
const response = await fetch('https://api.agenticpencil.com/v1/content/recommend', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer ap_your_api_key_here',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    domain: 'sonant.ai',
    focus_topics: ['ai receptionist', 'insurance automation'],
    brand_context: 'AI receptionist for P&C insurance agencies',
    country: 'US',
    limit: 5
  })
});

Authorization

Authorization
string
required
Bearer token. Format: Bearer ap_your_api_key

Request Body

domain
string
required
Your website domain (e.g., “example.com”)
focus_topics
string[]
Topics to focus recommendations on (e.g., [“ai receptionist”, “insurance automation”])
brand_context
string
Description of your brand/product for more relevant recommendations
competitors
string[]
Competitor domains for gap analysis (max 3)
country
string
Two-letter country code (default: “US”)
limit
integer
Maximum recommendations to return (default: 10)

Response

{
  "success": true,
  "data": {
    "plan_id": "abc-123",
    "domain": "sonant.ai",
    "existing_keywords": 50,
    "sitemap_pages": 229,
    "recommendations": [
      {
        "priority": 1,
        "title": "Ai Receptionist: What You Need to Know",
        "target_keyword": "ai receptionist",
        "search_volume": 500,
        "keyword_difficulty": 30,
        "opportunity_score": 85,
        "search_intent": "informational",
        "outline": [
          { "h2": "What Is an AI Receptionist?", "talking_points": ["definition", "key features"] },
          { "h2": "Benefits for Insurance Agencies", "talking_points": ["24/7 availability", "cost savings"] },
          { "h2": "How to Choose the Right Solution", "talking_points": ["comparison criteria", "pricing"] }
        ],
        "related_keywords": ["virtual receptionist", "ai phone answering"]
      }
    ],
    "cannibalization": [
      {
        "keyword": "ai receptionist",
        "urls": ["/blog/ai-receptionist", "/features"],
        "recommendation": "Consolidate these pages or differentiate their target keywords"
      }
    ],
    "total_recommendations": 1
  },
  "meta": {
    "credits_used": 15,
    "credits_remaining": 985,
    "request_id": "abc-123"
  }
}
{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "domain is required"
  }
}
Credit Cost: 15 credits per request