Keyword Analysis
developer/v1/domain/keyword-analysisPerforms on-page keyword analysis including keyword extraction, density calculation, phrase analysis, and alignment checks between title, headings, meta description, and content.
What It Does
Extracts and analyzes keywords from page elements: title tag, meta description, H1/H2 headings, and body content. Calculates density for single words, two-word phrases, and three-word phrases. Checks keyword alignment across page elements (does the title contain the top keyword? does the H1?). Evaluates content focus as focused, moderate, or scattered.
Why It's Useful
Keyword optimization is foundational to SEO. This analysis reveals whether your content is focused on target keywords, whether key page elements are aligned, and identifies over-optimization or keyword stuffing risks.
Use Cases
Content Optimization
Analyze a published page to verify keyword usage and density align with target terms.
Optimize content for target keywords without over-optimization.
Competitive Keyword Analysis
Analyze competitor pages to understand which keywords they target and how they optimize.
Inform content strategy based on competitor keyword targeting.
Content Audit
Bulk-analyze pages across a site to identify keyword cannibalization and content gaps.
Resolve keyword conflicts and find new content opportunities.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
domain | string | Required | The domain to perform keyword analysis onExample: example.com |
Response Fields
| Field | Type | Description |
|---|---|---|
domain | string | The analyzed domain |
targetKeywords | array | Inferred target keywords from title, H1, and meta description |
titleKeywords | array | Keywords found in the title tag |
metaDescriptionKeywords | array | Keywords found in the meta description |
h1Keywords | array | Keywords found in H1 headings |
h2Keywords | array | Keywords found in H2 headings |
singleWords | array | Top single keywords with count and density |
twoWordPhrases | array | Top two-word phrases with density |
threeWordPhrases | array | Top three-word phrases with density |
keywordAlignment | object | Whether top keywords appear in title, H1, URL, and meta |
metaKeywords | object | Meta keywords tag analysis with present flag, keywords array, and note |
contentFocus | object | Content focus score and assessment (focused/moderate/scattered) |
wordCount | number | Total word count of page content |
score | number | Keyword optimization score (0-100) |
grade | string | Letter grade (A-F) based on score |
recommendations | array | Keyword optimization suggestions |
Code Examples
curl "https://api.edgedns.dev/v1/domain/keyword-analysis" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d "domain=example.com"const response = await fetch(
'https://api.edgedns.dev/v1/domain/keyword-analysis?domain=example.com',
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const data = await response.json();
console.log(data);import requests
response = requests.get(
'https://api.edgedns.dev/v1/domain/keyword-analysis',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
params={
'domain': 'example.com'
}
)
data = response.json()
print(data)Read the full Keyword Analysis guide
Why it matters, real-world use cases, parameters, response fields, and how to call it from Claude, ChatGPT, or Gemini via MCP.
Read the guide →Related Endpoints
External References
Learn more about the standards and protocols behind this endpoint.
Try This Endpoint
Test the Keyword Analysis endpoint live in the playground.