Skip to main content
POST
/
v1
/
keywords
/
gaps
curl -X POST "https://api.agenticpencil.com/v1/keywords/gaps" \
  -H "Authorization: Bearer ap_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "sonant.ai",
    "competitors": ["smith.ai", "ruby.com"],
    "country": "us",
    "limit": 20
  }'

{
  "success": true,
  "data": {
    "domain": "sonant.ai",
    "competitors": ["smith.ai"],
    "gaps": [
      {
        "keyword": "virtual receptionist service",
        "search_volume": 3600,
        "keyword_difficulty": 45,
        "competitor_positions": { "smith.ai": 5 }
      }
    ],
    "total_gaps": 1
  },
  "meta": {
    "credits_used": 10,
    "credits_remaining": 990,
    "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.

Discover keyword opportunities by analyzing gaps between your domain and competitors. 
curl -X POST "https://api.agenticpencil.com/v1/keywords/gaps" \
  -H "Authorization: Bearer ap_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "sonant.ai",
    "competitors": ["smith.ai", "ruby.com"],
    "country": "us",
    "limit": 20
  }'

​
Authorization

​
Authorization
string
required
Bearer token. Format: Bearer ap_your_api_key

​
Request Body

​
domain
string
required
Your website domain
​
competitors
string[]
required
Competitor domains to compare against (1-3)
​
country
string
Two-letter country code (default: “us”)
​
limit
integer
Maximum gaps to return (default: 50)

​
Response

{
  "success": true,
  "data": {
    "domain": "sonant.ai",
    "competitors": ["smith.ai"],
    "gaps": [
      {
        "keyword": "virtual receptionist service",
        "search_volume": 3600,
        "keyword_difficulty": 45,
        "competitor_positions": { "smith.ai": 5 }
      }
    ],
    "total_gaps": 1
  },
  "meta": {
    "credits_used": 10,
    "credits_remaining": 990,
    "request_id": "abc-123"
  }
}
Credit Cost: 10 credits per request