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
  }'
{
  "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"
  }
}
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
  }'

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"
  }
}
Credit Cost: 15 credits per request