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"
}
}
Endpoints
Keyword Gaps
Find keywords your competitors rank for but you don’t
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"
}
}
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
string
required
Bearer token. Format:
Bearer ap_your_api_keyRequest Body
string
required
Your website domain
string[]
required
Competitor domains to compare against (1-3)
string
Two-letter country code (default: “us”)
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