Skip to main content
POST
/
v1
/
content-map
curl -X POST "https://api.agenticpencil.com/v1/content-map" \
  -H "Authorization: Bearer ap_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "sonant.ai",
    "focus_topics": ["ai receptionist", "insurance automation"],
    "competitors": ["smith.ai"],
    "country": "US",
    "limit": 10
  }'

{
  "success": true,
  "data": {
    "domain": "sonant.ai",
    "generated_at": "2026-02-18T16:00:00.000Z",
    "audit": {
      "pages_found": 229,
      "pages": [{ "url": "https://sonant.ai/" }, { "url": "https://sonant.ai/blog" }]
    },
    "current_rankings": {
      "count": 50,
      "keywords": [
        { "keyword": "sonant ai", "search_volume": 200, "keyword_difficulty": 10, "position": 1 }
      ]
    },
    "competitor_gaps": {
      "count": 15,
      "gaps": [
        { "keyword": "virtual receptionist", "search_volume": 3600, "keyword_difficulty": 45 }
      ]
    },
    "recommendations": [
      {
        "priority": 1,
        "target_keyword": "ai receptionist",
        "search_volume": 500,
        "keyword_difficulty": 30,
        "cpc": 5.2,
        "search_intent": "commercial",
        "opportunity_score": 85
      }
    ],
    "summary": {
      "pages_found": 229,
      "current_rankings": 50,
      "keyword_opportunities": 15,
      "competitor_gaps": 15,
      "recommendations": 10
    }
  },
  "meta": {
    "credits_used": 25,
    "credits_remaining": 975,
    "request_id": "abc-123"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.agenticpencil.com/llms.txt

Use this file to discover all available pages before exploring further.

The mega-endpoint for AI agents. Get a complete content strategy in a single API call: sitemap audit, current rankings, competitor gaps, and prioritized recommendations. Recommended for AI agent integrations — one call gives you everything you need. 
curl -X POST "https://api.agenticpencil.com/v1/content-map" \
  -H "Authorization: Bearer ap_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "sonant.ai",
    "focus_topics": ["ai receptionist", "insurance automation"],
    "competitors": ["smith.ai"],
    "country": "US",
    "limit": 10
  }'

​
Authorization

​
Authorization
string
required
Bearer token. Format: Bearer ap_your_api_key

​
Request Body

​
domain
string
required
Your website domain
​
focus_topics
string[]
Topics to focus on (highly recommended for small domains)
​
competitors
string[]
Competitor domains for gap analysis (max 3)
​
brand_context
string
Description of your brand for better recommendations
​
country
string
Two-letter country code (default: “US”)
​
limit
integer
Maximum recommendations (default: 20)

​
Response

{
  "success": true,
  "data": {
    "domain": "sonant.ai",
    "generated_at": "2026-02-18T16:00:00.000Z",
    "audit": {
      "pages_found": 229,
      "pages": [{ "url": "https://sonant.ai/" }, { "url": "https://sonant.ai/blog" }]
    },
    "current_rankings": {
      "count": 50,
      "keywords": [
        { "keyword": "sonant ai", "search_volume": 200, "keyword_difficulty": 10, "position": 1 }
      ]
    },
    "competitor_gaps": {
      "count": 15,
      "gaps": [
        { "keyword": "virtual receptionist", "search_volume": 3600, "keyword_difficulty": 45 }
      ]
    },
    "recommendations": [
      {
        "priority": 1,
        "target_keyword": "ai receptionist",
        "search_volume": 500,
        "keyword_difficulty": 30,
        "cpc": 5.2,
        "search_intent": "commercial",
        "opportunity_score": 85
      }
    ],
    "summary": {
      "pages_found": 229,
      "current_rankings": 50,
      "keyword_opportunities": 15,
      "competitor_gaps": 15,
      "recommendations": 10
    }
  },
  "meta": {
    "credits_used": 25,
    "credits_remaining": 975,
    "request_id": "abc-123"
  }
}
Credit Cost: 25 credits per request
For small/new domains: Always include focus_topics — DataForSEO may have limited data for domains with low traffic, but focus topics ensure you still get actionable recommendations.