Skip to main content
POST
/
v1
/
keywords
/
research
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"
  }
}
Discover keyword opportunities with clustering, search volume, difficulty scores, and intent analysis. 
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 })
});

​
Authorization

​
Authorization
string
required
Bearer token. Format: Bearer ap_your_api_key

​
Request Body

​
domain
string
required
Your website domain (e.g., “example.com”)
​
topic
string
Topic or niche to research keywords for
​
keywords
string[]
Seed keywords to use instead of topic
​
country
string
Two-letter country code (default: “us”). Supported: us, uk, ca, au, de, fr, es, it, br, pt, nl, in
​
language
string
Language code (default: “en”). Supported: en, de, fr, es, it, pt, nl, tr
​
limit
integer
Maximum keywords per source (default: 50)

​
Response

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