curl -X POST "https://api.agenticpencil.com/v1/keywords/research" \
  -H "Authorization: Bearer ap_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "sonant.ai",
    "topic": "ai receptionist",
    "country": "us",
    "limit": 20
  }'

import requests

response = requests.post(
    "https://api.agenticpencil.com/v1/keywords/research",
    headers={"Authorization": "Bearer ap_your_api_key_here"},
    json={"domain": "sonant.ai", "topic": "ai receptionist", "country": "us", "limit": 20}
)

const response = await fetch('https://api.agenticpencil.com/v1/keywords/research', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer ap_your_api_key_here', 'Content-Type': 'application/json' },
  body: JSON.stringify({ domain: 'sonant.ai', topic: 'ai receptionist', country: 'us', limit: 20 })
});

{
  "success": true,
  "data": {
    "domain": "sonant.ai",
    "topic": "ai receptionist",
    "country": "us",
    "clusters": [
      {
        "cluster_name": "ai receptionist",
        "total_volume": 4500,
        "avg_difficulty": 35,
        "keywords": [
          {
            "keyword": "ai receptionist",
            "search_volume": 2400,
            "keyword_difficulty": 32,
            "cpc": 5.2,
            "search_intent": "commercial"
          }
        ]
      }
    ],
    "total_keywords": 45
  },
  "meta": {
    "credits_used": 5,
    "credits_remaining": 995,
    "request_id": "abc-123"
  }
}