Skip to main content

​
Get Your API Key

First, you’ll need to get your API key from the AgenticPencil platform:
1

Sign Up

Visit platform.agenticpencil.com and create your account
2

Verify Email

Check your inbox and verify your email address
3

Generate API Key

Navigate to the API Keys section and generate your first key
Your API key will start with ap_ and look like this: ap_1234567890abcdef
Keep your API key secure! Never expose it in client-side code or public repositories.

​
Make Your First API Call

Let’s start with a simple keyword research request to get you familiar with the API: 
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": "example.com",
    "topic": "sustainable fashion",
    "country": "US",
    "limit": 10
  }'

import requests

url = "https://api.agenticpencil.com/v1/keywords/research"
headers = {
    "Authorization": "Bearer ap_your_api_key_here",
    "Content-Type": "application/json"
}
data = {
    "domain": "example.com",
    "topic": "sustainable fashion",
    "country": "US",
    "limit": 10
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)

const axios = require('axios');

const response = await axios.post(
  'https://api.agenticpencil.com/v1/keywords/research',
  {
    domain: 'example.com',
    topic: 'sustainable fashion',
    country: 'US',
    limit: 10
  },
  {
    headers: {
      'Authorization': 'Bearer ap_your_api_key_here',
      'Content-Type': 'application/json'
    }
  }
);

console.log(response.data);

​
Understanding the Response

You’ll receive a structured response with keyword opportunities:
Example Response
{
  "status": "success",
  "data": {
    "keywords": [
      {
        "keyword": "eco-friendly clothing brands",
        "search_volume": 12000,
        "competition": "medium",
        "cpc": 1.25,
        "trend": "increasing",
        "difficulty": 45,
        "opportunity_score": 78
      },
      {
        "keyword": "sustainable fashion tips",
        "search_volume": 8500,
        "competition": "low",
        "cpc": 0.85,
        "trend": "stable",
        "difficulty": 32,
        "opportunity_score": 82
      }
    ],
    "total_found": 10,
    "credits_used": 5
  },
  "credits_remaining": 45
}

​
Key Response Fields

​
keyword
string
The keyword phrase
​
search_volume
number
Monthly search volume
​
competition
string
Competition level: low, medium, or high
​
opportunity_score
number
AgenticPencil’s proprietary opportunity score (1-100, higher is better)
​
credits_used
number
Number of credits consumed by this request

​
Next Steps

Now that you’ve made your first successful API call, explore these powerful features:

Content Gap Analysis

Find keywords your competitors rank for but you don’t

Content Audit

Analyze your existing content performance

Content Recommendations

Get AI-powered content strategy suggestions

Usage Tracking

Monitor your API usage and credit consumption

​
Error Handling

Always check the response status and handle errors gracefully:
Error Handling Example
import requests

try:
    response = requests.post(url, headers=headers, json=data)
    response.raise_for_status()  # Raises an HTTPError for bad responses
    
    result = response.json()
    if result.get('status') == 'success':
        # Process successful response
        keywords = result['data']['keywords']
    else:
        # Handle API-level errors
        print(f"API Error: {result.get('error', 'Unknown error')}")
        
except requests.exceptions.RequestException as e:
    print(f"Request failed: {e}")
Start with small requests to understand the API structure, then scale up as you build confidence with the responses.