Quickstart

Get Your API Key

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

Visit platform.agenticpencil.com and create your account

Verify Email

Check your inbox and verify your email address

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

string

The keyword phrase

number

Monthly search volume

string

Competition level: low, medium, or high

number

AgenticPencil’s proprietary opportunity score (1-100, higher is better)

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.

Get Started

Resources

Get Your API Key

Make Your First API Call

Understanding the Response

Key Response Fields

Next Steps

Content Gap Analysis

Content Audit

Content Recommendations

Usage Tracking

Error Handling

​Get Your API Key

​Make Your First API Call

​Understanding the Response

​Key Response Fields

​Next Steps

Content Gap Analysis

Content Audit

Content Recommendations

Usage Tracking

​Error Handling

Get Your API Key

Make Your First API Call

Understanding the Response

Key Response Fields

Next Steps

Error Handling