https://www.brainiac.software/api/v1/seo-content/tfidf-term-gap$0.04 USDCTF-IDF term gap vs competitor pages
Find stemmed terms common among competitor pages but missing or under-used in a draft, ranked by TF-IDF gap.
Body
| Field | Required | Notes |
|---|---|---|
draft | Yes | string |
competitors | Yes | array; Array |
language | No | string; Default: "en" |
minDocFrequency | No | integer; Default: 2 |
limit | No | integer; Default: 50 |
Request exampleJSON
{
"draft": "Our solar panel cost guide explains prices.",
"competitors": [
"Solar panel installation cost depends on roof size. Solar panel grants reduce the installation cost.",
"Solar panel cost includes battery storage. Grants are available for solar panel battery storage.",
"How much does solar panel installation cost? Installation cost varies by roof."
],
"language": "en",
"minDocFrequency": 2,
"limit": 20
}Response exampleJSON
{
"gaps": [
{
"term": "instal",
"display": "installation",
"competitorAvgTfidf": 0.091569,
"draftTfidf": 0,
"gap": 0.091569,
"docFrequency": 2
},
{
"term": "instal cost",
"display": "installation cost",
"competitorAvgTfidf": 0.091569,
"draftTfidf": 0,
"gap": 0.091569,
"docFrequency": 2
},
"…"
],
"lowConfidence": true,
"duplicatesIgnored": [],
"sources": [
{
"source": "Caller-supplied texts, keywords and rank snapshots processed locally",
"url": "https://www.brainiac.software/api/v1/seo-content",
"retrievedAt": "2026-11-14",
"status": "ok"
},
{
"source": "stopwords-iso English list 1.1.0",
"url": "https://github.com/stopwords-iso/stopwords-iso",
"retrievedAt": "2026-11-14",
"status": "ok"
}
],
"limitations": [
"TF-IDF uses competitor documents only for IDF. No SERP or keyword database is queried.",
"English Snowball stemming and stopwords-iso only; other languages return unsupported_language.",
"…"
]
}cURL
curl -i -X POST "https://www.brainiac.software/api/v1/seo-content/tfidf-term-gap" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"draft": "Our solar panel cost guide explains prices.",
"competitors": [
"Solar panel installation cost depends on roof size. Solar panel grants reduce the installation cost.",
"Solar panel cost includes battery storage. Grants are available for solar panel battery storage.",
"How much does solar panel installation cost? Installation cost varies by roof."
],
"language": "en",
"minDocFrequency": 2,
"limit": 20
}
JSONhttps://www.brainiac.software/api/v1/seo-content/brief-from-serp-texts$0.04 USDCContent brief from SERP page texts
Build a content brief from caller-supplied top-ranking HTML: common headings, word-count target, questions and recommended TF-IDF terms.
Body
| Field | Required | Notes |
|---|---|---|
pages | Yes | array; Array |
language | No | string; Default: "en" |
minHeadingShare | No | number; Default: 0.5 |
termLimit | No | integer; Default: 30 |
Request exampleJSON
{
"pages": [
{
"url": "https://a.example/solar",
"html": "<h1>How much do solar panels cost?</h1><h2>Are solar grants available?</h2><h2>Payback period</h2>"
},
{
"url": "https://b.example/solar",
"html": "<h1>Solar panel costs</h1><h2>Solar Grants</h2><h2>Maintenance</h2>"
},
{
"url": "https://c.example/solar",
"html": "<h1>Solar panel cost</h1><h2>Payback period</h2><h2>Our team</h2>"
}
],
"language": "en",
"minHeadingShare": 0.5,
"termLimit": 30
}Response exampleJSON
{
"wordCount": {
"median": 7,
"min": 6,
"max": 12
},
"commonHeadings": [
{
"label": "How much do solar panels cost?",
"share": 1,
"pages": 3
},
{
"label": "Are solar grants available?",
"share": 0.666667,
"pages": 2
},
"…"
],
"questions": [
"How much do solar panels cost?",
"Are solar grants available?"
],
"recommendedTerms": [
{
"term": "solar",
"meanTfidf": 0.142191,
"docFrequency": 3
},
{
"term": "cost",
"meanTfidf": 0.086247,
"docFrequency": 3
},
"…"
],
"duplicatesIgnored": [],
"notes": [
"Boilerplate removal is heuristic"
],
"sources": [
{
"source": "Caller-supplied texts, keywords and rank snapshots processed locally",
"url": "https://www.brainiac.software/api/v1/seo-content",
"retrievedAt": "2026-11-14",
"status": "ok"
},
{
"source": "stopwords-iso English list 1.1.0",
"url": "https://github.com/stopwords-iso/stopwords-iso",
"retrievedAt": "2026-11-14",
"status": "ok"
}
],
"limitations": [
"No live SERP fetch; pages are caller-supplied HTML only.",
"Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…"
]
}cURL
curl -i -X POST "https://www.brainiac.software/api/v1/seo-content/brief-from-serp-texts" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"pages": [
{
"url": "https://a.example/solar",
"html": "<h1>How much do solar panels cost?</h1><h2>Are solar grants available?</h2><h2>Payback period</h2>"
},
{
"url": "https://b.example/solar",
"html": "<h1>Solar panel costs</h1><h2>Solar Grants</h2><h2>Maintenance</h2>"
},
{
"url": "https://c.example/solar",
"html": "<h1>Solar panel cost</h1><h2>Payback period</h2><h2>Our team</h2>"
}
],
"language": "en",
"minHeadingShare": 0.5,
"termLimit": 30
}
JSONhttps://www.brainiac.software/api/v1/seo-content/readability-score$0.02 USDCEnglish readability metrics
Compute Flesch Reading Ease, Flesch-Kincaid, Gunning Fog, SMOG and Coleman-Liau from caller text.
Body
| Field | Required | Notes |
|---|---|---|
text | Yes | string |
language | No | string; Default: "en" |
Request exampleJSON
{
"text": "The cat sat on the mat. It was a sunny day, and the cat was happy. Readability formulas estimate how difficult a passage is to understand.",
"language": "en"
}Response exampleJSON
{
"counts": {
"sentences": 3,
"words": 26,
"syllables": 41,
"letters": 109,
"polysyllables": 5
},
"fleschReadingEase": 64.6306,
"fleschKincaidGrade": 6.3977,
"gunningFog": 11.159,
"smog": 10.5042,
"colemanLiau": 5.4354,
"avgSentenceLength": 8.6667,
"avgSyllablesPerWord": 1.5769,
"smogReliable": false,
"sources": [
{
"source": "Caller-supplied texts, keywords and rank snapshots processed locally",
"url": "https://www.brainiac.software/api/v1/seo-content",
"retrievedAt": "2026-11-14",
"status": "ok"
}
],
"limitations": [
"English formulas only. Syllable counting is heuristic.",
"Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…"
]
}cURL
curl -i -X POST "https://www.brainiac.software/api/v1/seo-content/readability-score" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"text": "The cat sat on the mat. It was a sunny day, and the cat was happy. Readability formulas estimate how difficult a passage is to understand.",
"language": "en"
}
JSONhttps://www.brainiac.software/api/v1/seo-content/near-duplicate-detect$0.03 USDCNear-duplicate page clustering
Cluster near-duplicate pages with Jaccard similarity on token shingles and connected-component clustering.
Body
| Field | Required | Notes |
|---|---|---|
pages | Yes | array; Array |
shingleSize | No | integer; Default: 3 |
threshold | No | number; Default: 0.8 |
Request exampleJSON
{
"pages": [
{
"id": "p1",
"text": "the quick brown fox jumps over the lazy dog today"
},
{
"id": "p2",
"text": "the quick brown fox jumps over the lazy dog tonight"
},
{
"id": "p3",
"text": "the quick brown fox leaps over the lazy dog today"
},
{
"id": "p4",
"text": "lorem ipsum dolor sit amet consectetur adipiscing elit"
}
],
"shingleSize": 3,
"threshold": 0.4
}Response exampleJSON
{
"pairs": [
{
"a": "p1",
"b": "p2",
"jaccard": 0.777778
},
{
"a": "p1",
"b": "p3",
"jaccard": 0.454545
}
],
"clusters": [
[
"p1",
"p2",
"…"
]
],
"singletons": [
"p4"
],
"shingleSize": 3,
"excluded": [],
"sources": [
{
"source": "Caller-supplied texts, keywords and rank snapshots processed locally",
"url": "https://www.brainiac.software/api/v1/seo-content",
"retrievedAt": "2026-11-14",
"status": "ok"
}
],
"limitations": [
"Exact Jaccard on character-token shingles; no MinHash. Callers should pass main content.",
"Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…"
]
}cURL
curl -i -X POST "https://www.brainiac.software/api/v1/seo-content/near-duplicate-detect" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"pages": [
{
"id": "p1",
"text": "the quick brown fox jumps over the lazy dog today"
},
{
"id": "p2",
"text": "the quick brown fox jumps over the lazy dog tonight"
},
{
"id": "p3",
"text": "the quick brown fox leaps over the lazy dog today"
},
{
"id": "p4",
"text": "lorem ipsum dolor sit amet consectetur adipiscing elit"
}
],
"shingleSize": 3,
"threshold": 0.4
}
JSONhttps://www.brainiac.software/api/v1/seo-content/internal-link-suggest$0.04 USDCInternal link suggestions
Suggest internal links by unigram TF-IDF cosine similarity and extract exact or partial anchor text from target keywords.
Body
| Field | Required | Notes |
|---|---|---|
pages | Yes | array; Array |
existingLinks | No | array; Default: []; Array |
minSimilarity | No | number; Default: 0.2 |
maxPerSource | No | integer; Default: 5 |
Request exampleJSON
{
"pages": [
{
"url": "/solar-cost",
"text": "Solar panel cost guide: installation cost, grants and payback for solar panels.",
"targetKeywords": [
"solar panel cost"
]
},
{
"url": "/solar-grants",
"text": "Solar panel grants explained: who qualifies for grants and how grants cut solar panel cost.",
"targetKeywords": [
"solar panel grants"
]
},
{
"url": "/heat-pumps",
"text": "Heat pump installation: air source heat pump cost and grants.",
"targetKeywords": [
"heat pump"
]
},
{
"url": "/battery",
"text": "Battery storage for solar panels: battery cost and payback.",
"targetKeywords": [
"battery storage"
]
}
],
"existingLinks": [
[
"/solar-grants",
"/solar-cost"
]
],
"minSimilarity": 0.3,
"maxPerSource": 5
}Response exampleJSON
{
"suggestions": [
{
"source": "/solar-cost",
"target": "/solar-grants",
"similarity": 0.594907,
"anchor": "Solar panel",
"anchorType": "partial"
},
{
"source": "/solar-cost",
"target": "/battery",
"similarity": 0.408013,
"anchor": null,
"anchorType": null
},
"…"
],
"sources": [
{
"source": "Caller-supplied texts, keywords and rank snapshots processed locally",
"url": "https://www.brainiac.software/api/v1/seo-content",
"retrievedAt": "2026-11-14",
"status": "ok"
},
{
"source": "stopwords-iso English list 1.1.0",
"url": "https://github.com/stopwords-iso/stopwords-iso",
"retrievedAt": "2026-11-14",
"status": "ok"
}
],
"limitations": [
"Cosine similarity on unigram TF-IDF only. Existing links are excluded as directed pairs.",
"Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…"
]
}cURL
curl -i -X POST "https://www.brainiac.software/api/v1/seo-content/internal-link-suggest" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"pages": [
{
"url": "/solar-cost",
"text": "Solar panel cost guide: installation cost, grants and payback for solar panels.",
"targetKeywords": [
"solar panel cost"
]
},
{
"url": "/solar-grants",
"text": "Solar panel grants explained: who qualifies for grants and how grants cut solar panel cost.",
"targetKeywords": [
"solar panel grants"
]
},
{
"url": "/heat-pumps",
"text": "Heat pump installation: air source heat pump cost and grants.",
"targetKeywords": [
"heat pump"
]
},
{
"url": "/battery",
"text": "Battery storage for solar panels: battery cost and payback.",
"targetKeywords": [
"battery storage"
]
}
],
"existingLinks": [
[
"/solar-grants",
"/solar-cost"
]
],
"minSimilarity": 0.3,
"maxPerSource": 5
}
JSONhttps://www.brainiac.software/api/v1/seo-content/keyword-intent-classify$0.02 USDCRule-based keyword intent labels
Label keywords as navigational, transactional, commercial or informational from bundled English modifier rules and caller brands.
Body
| Field | Required | Notes |
|---|---|---|
keywords | Yes | array; Array |
brands | No | array; Default: []; Array |
language | No | string; Default: "en" |
Request exampleJSON
{
"keywords": [
"buy solar panels",
"best solar panels 2026",
"how do solar panels work",
"acme solar login",
"solar panels"
],
"brands": [
"acme solar"
],
"language": "en"
}Response exampleJSON
{
"results": [
{
"keyword": "buy solar panels",
"intents": [
"transactional"
],
"reasons": [
"modifier:buy"
]
},
{
"keyword": "best solar panels 2026",
"intents": [
"commercial"
],
"reasons": [
"modifier:best"
]
},
"…"
],
"sources": [
{
"source": "Bundled English intent modifier rules",
"url": "https://www.brainiac.software/api/v1/seo-content",
"retrievedAt": "2026-11-14",
"status": "ok"
}
],
"limitations": [
"Rule-based whole-token/phrase matches only; no ML intent model.",
"Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…"
]
}cURL
curl -i -X POST "https://www.brainiac.software/api/v1/seo-content/keyword-intent-classify" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"keywords": [
"buy solar panels",
"best solar panels 2026",
"how do solar panels work",
"acme solar login",
"solar panels"
],
"brands": [
"acme solar"
],
"language": "en"
}
JSONhttps://www.brainiac.software/api/v1/seo-content/keyword-group-lexical$0.03 USDCLexical keyword grouping
Group keywords that share the same Porter2 stem signature, optionally merging groups by SERP URL overlap.
Body
| Field | Required | Notes |
|---|---|---|
keywords | Yes | array; Array |
serps | No | — |
minSharedUrls | No | integer; Default: 3 |
maxGroupSize | No | integer; Default: 500 |
Request exampleJSON
{
"keywords": [
"solar panel cost",
"cost of solar panels",
"solar panels price",
"solar panel installation",
"install solar panels",
"best solar panels"
],
"serps": null,
"minSharedUrls": 3,
"maxGroupSize": 500
}Response exampleJSON
{
"groups": [
{
"signature": [
"cost",
"panel",
"…"
],
"keywords": [
"solar panel cost",
"cost of solar panels"
]
},
{
"signature": [
"instal",
"panel",
"…"
],
"keywords": [
"solar panel installation",
"install solar panels"
]
},
"…"
],
"ungrouped": [],
"sources": [
{
"source": "Caller-supplied texts, keywords and rank snapshots processed locally",
"url": "https://www.brainiac.software/api/v1/seo-content",
"retrievedAt": "2026-11-14",
"status": "ok"
}
],
"limitations": [
"Lexical grouping uses Porter2 stems with a small function-word list only; SERP merge is optional and caller-supplied.",
"Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…"
]
}cURL
curl -i -X POST "https://www.brainiac.software/api/v1/seo-content/keyword-group-lexical" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"keywords": [
"solar panel cost",
"cost of solar panels",
"solar panels price",
"solar panel installation",
"install solar panels",
"best solar panels"
],
"serps": null,
"minSharedUrls": 3,
"maxGroupSize": 500
}
JSONhttps://www.brainiac.software/api/v1/seo-content/keyword-difficulty-estimate$0.02 USDCTransparent keyword difficulty
Estimate keyword difficulty as 100 × mean of capped log referring-domain scores from the caller-supplied top results.
Body
| Field | Required | Notes |
|---|---|---|
keyword | Yes | string |
results | Yes | array; Array |
referenceCap | No | integer; Default: 1000 |
serpFeatures | No | array; Default: []; Array |
Request exampleJSON
{
"keyword": "solar panel cost",
"results": [
{
"position": 1,
"referringDomains": 1200
},
{
"position": 2,
"referringDomains": 850
},
{
"position": 3,
"referringDomains": 400
},
{
"position": 4,
"referringDomains": 300
},
{
"position": 5,
"referringDomains": 150
},
{
"position": 6,
"referringDomains": 90
},
{
"position": 7,
"referringDomains": 60
},
{
"position": 8,
"referringDomains": 40
},
{
"position": 9,
"referringDomains": 20
},
{
"position": 10,
"referringDomains": 10
}
],
"referenceCap": 1000,
"serpFeatures": []
}Response exampleJSON
{
"difficulty": 70,
"difficultyExact": 69.696,
"components": [
1,
0.976502,
"…"
],
"coverage": 10,
"formula": "100 × mean(min(1, log10(1+RD_i) / log10(1+cap)))",
"serpFeatureCount": 0,
"lowConfidence": false,
"sources": [
{
"source": "Caller-supplied texts, keywords and rank snapshots processed locally",
"url": "https://www.brainiac.software/api/v1/seo-content",
"retrievedAt": "2026-11-14",
"status": "ok"
}
],
"limitations": [
"Transparent score from caller-supplied referring-domain counts only; not Ahrefs/Semrush KD.",
"Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…"
]
}cURL
curl -i -X POST "https://www.brainiac.software/api/v1/seo-content/keyword-difficulty-estimate" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"keyword": "solar panel cost",
"results": [
{
"position": 1,
"referringDomains": 1200
},
{
"position": 2,
"referringDomains": 850
},
{
"position": 3,
"referringDomains": 400
},
{
"position": 4,
"referringDomains": 300
},
{
"position": 5,
"referringDomains": 150
},
{
"position": 6,
"referringDomains": 90
},
{
"position": 7,
"referringDomains": 60
},
{
"position": 8,
"referringDomains": 40
},
{
"position": 9,
"referringDomains": 20
},
{
"position": 10,
"referringDomains": 10
}
],
"referenceCap": 1000,
"serpFeatures": []
}
JSONhttps://www.brainiac.software/api/v1/seo-content/heading-outline-compare$0.03 USDCHeading outline gap analysis
Compare a target H1–H6 outline with competitors and list common sections the target lacks.
Body
| Field | Required | Notes |
|---|---|---|
target | Yes | object; Object |
competitors | Yes | array; Array |
minShare | No | number; Default: 0.5 |
Request exampleJSON
{
"target": {
"url": "/mine",
"html": "<h1>Solar panel costs</h1><h2>Battery storage</h2>"
},
"competitors": [
{
"url": "A",
"html": "<h1>How much do solar panels cost?</h1><h2>Are solar grants available?</h2><h2>Payback period</h2>"
},
{
"url": "B",
"html": "<h1>Solar panel costs</h1><h2>Solar Grants</h2><h2>Maintenance</h2>"
},
{
"url": "C",
"html": "<h1>Solar panel cost</h1><h2>Payback period</h2><h2>Our team</h2>"
}
],
"minShare": 0.5
}Response exampleJSON
{
"targetOutline": [
{
"level": 1,
"text": "Solar panel costs"
},
{
"level": 2,
"text": "Battery storage"
}
],
"missing": [
{
"label": "Are solar grants available?",
"share": 0.666667,
"competitors": [
"A",
"B"
]
},
{
"label": "Payback period",
"share": 0.666667,
"competitors": [
"A",
"C"
]
}
],
"targetOnly": [
"Battery storage"
],
"warnings": [],
"sources": [
{
"source": "Caller-supplied texts, keywords and rank snapshots processed locally",
"url": "https://www.brainiac.software/api/v1/seo-content",
"retrievedAt": "2026-11-14",
"status": "ok"
},
{
"source": "stopwords-iso English list 1.1.0",
"url": "https://github.com/stopwords-iso/stopwords-iso",
"retrievedAt": "2026-11-14",
"status": "ok"
}
],
"limitations": [
"Heading keys are sorted content stems; boilerplate headings may still appear.",
"Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…"
]
}cURL
curl -i -X POST "https://www.brainiac.software/api/v1/seo-content/heading-outline-compare" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"target": {
"url": "/mine",
"html": "<h1>Solar panel costs</h1><h2>Battery storage</h2>"
},
"competitors": [
{
"url": "A",
"html": "<h1>How much do solar panels cost?</h1><h2>Are solar grants available?</h2><h2>Payback period</h2>"
},
{
"url": "B",
"html": "<h1>Solar panel costs</h1><h2>Solar Grants</h2><h2>Maintenance</h2>"
},
{
"url": "C",
"html": "<h1>Solar panel cost</h1><h2>Payback period</h2><h2>Our team</h2>"
}
],
"minShare": 0.5
}
JSONhttps://www.brainiac.software/api/v1/seo-content/serp-snippet-preview$0.02 USDCSERP snippet pixel-width preview
Estimate title and meta description pixel widths with Liberation Sans advances and truncate at caller-chosen limits.
Body
| Field | Required | Notes |
|---|---|---|
title | Yes | string |
description | Yes | string |
titleFontPx | No | number; Default: 20 |
descriptionFontPx | No | number; Default: 14 |
titleMaxPx | No | — |
descriptionMaxPx | No | — |
Request exampleJSON
{
"title": "Solar Panel Grants 2026: Costs, Savings and How to Apply | Example",
"description": "Find out what solar panels cost in 2026, which grants you can claim and how long payback takes for a typical three-bedroom home in the UK.",
"titleFontPx": 20,
"descriptionFontPx": 14,
"titleMaxPx": 600,
"descriptionMaxPx": null
}Response exampleJSON
{
"title": {
"chars": 66,
"widthPx": 619.96,
"fits": false,
"truncatedAt": 58,
"truncated": "Solar Panel Grants 2026: Costs, Savings and How to Apply | …",
"truncatedWidthPx": 562.15
},
"description": {
"chars": 138,
"widthPx": 874.7,
"fits": null
},
"estimate": true,
"font": "Liberation Sans Regular 2.1.5 (metric-compatible with Arial)",
"sources": [
{
"source": "Liberation Sans Regular 2.1.5 advance widths (OFL-1.1)",
"url": "https://github.com/liberationfonts/liberation-fonts",
"retrievedAt": "2026-11-14",
"status": "ok"
}
],
"limitations": [
"Pixel widths are estimates from Liberation Sans advances without kerning; real SERPs differ by device.",
"Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…"
]
}cURL
curl -i -X POST "https://www.brainiac.software/api/v1/seo-content/serp-snippet-preview" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"title": "Solar Panel Grants 2026: Costs, Savings and How to Apply | Example",
"description": "Find out what solar panels cost in 2026, which grants you can claim and how long payback takes for a typical three-bedroom home in the UK.",
"titleFontPx": 20,
"descriptionFontPx": 14,
"titleMaxPx": 600,
"descriptionMaxPx": null
}
JSONhttps://www.brainiac.software/api/v1/seo-content/content-decay-detect$0.03 USDCContent decay Mann-Kendall test
Flag pages whose clicks or impressions show a statistically significant decline with Mann-Kendall, Sen slope and windowed percent change.
Body
| Field | Required | Notes |
|---|---|---|
series | Yes | array; Array |
period | No | — |
alpha | No | number; Default: 0.05 |
minDropPct | No | number; Default: 10 |
comparisonWindow | No | integer; Default: 3 |
Request exampleJSON
{
"series": [
{
"url": "/solar-cost",
"metric": "clicks",
"values": [
1200,
1180,
1210,
1150,
1100,
1120,
1050,
1000,
980,
940,
900,
870
]
},
{
"url": "/flat",
"metric": "clicks",
"values": [
100,
102,
99,
101,
100,
98,
103,
100,
99,
101,
100,
102
]
}
],
"period": null,
"alpha": 0.05,
"minDropPct": 10,
"comparisonWindow": 3
}Response exampleJSON
{
"results": [
{
"url": "/solar-cost",
"decaying": true,
"test": "mann_kendall",
"S": -60,
"varS": 212.6667,
"z": -4.04578,
"pValue": 0.0000522,
"senSlope": -33.333333,
"changePct": -24.5125
},
{
"url": "/flat",
"decaying": false,
"test": "mann_kendall",
"S": 5,
"varS": 201,
"z": 0.282138,
"pValue": 0.7778376,
"senSlope": 0,
"changePct": 0.6645
}
],
"sources": [
{
"source": "Caller-supplied texts, keywords and rank snapshots processed locally",
"url": "https://www.brainiac.software/api/v1/seo-content",
"retrievedAt": "2026-11-14",
"status": "ok"
}
],
"limitations": [
"Mann-Kendall / Sen slope on caller-aggregated series only; not a causal traffic diagnosis.",
"Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…"
]
}cURL
curl -i -X POST "https://www.brainiac.software/api/v1/seo-content/content-decay-detect" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"series": [
{
"url": "/solar-cost",
"metric": "clicks",
"values": [
1200,
1180,
1210,
1150,
1100,
1120,
1050,
1000,
980,
940,
900,
870
]
},
{
"url": "/flat",
"metric": "clicks",
"values": [
100,
102,
99,
101,
100,
98,
103,
100,
99,
101,
100,
102
]
}
],
"period": null,
"alpha": 0.05,
"minDropPct": 10,
"comparisonWindow": 3
}
JSONhttps://www.brainiac.software/api/v1/seo-content/topic-coverage-score$0.03 USDCTopic coverage score
Score a draft against required subtopics with synonym phrases, listing covered, partial and missing topics.
Body
| Field | Required | Notes |
|---|---|---|
draft | Yes | string |
topics | Yes | array; Array |
partialThreshold | No | number; Default: 0.5 |
Request exampleJSON
{
"draft": "Solar panels cost less after installation grants. Payback takes nine years.",
"topics": [
{
"id": "cost",
"phrases": [
"solar panel cost",
"price of solar panels"
]
},
{
"id": "payback",
"phrases": [
"payback period"
]
},
{
"id": "battery",
"phrases": [
"battery storage"
]
}
],
"partialThreshold": 0.5
}Response exampleJSON
{
"score": 0.5,
"covered": [
{
"id": "cost",
"matchedPhrase": "solar panel cost"
}
],
"partial": [
{
"id": "payback",
"phrase": "payback period",
"matchedStems": [
"payback"
],
"fraction": 0.5
}
],
"missing": [
"battery"
],
"sources": [
{
"source": "Caller-supplied texts, keywords and rank snapshots processed locally",
"url": "https://www.brainiac.software/api/v1/seo-content",
"retrievedAt": "2026-11-14",
"status": "ok"
},
{
"source": "stopwords-iso English list 1.1.0",
"url": "https://github.com/stopwords-iso/stopwords-iso",
"retrievedAt": "2026-11-14",
"status": "ok"
}
],
"limitations": [
"Coverage uses contiguous stemmed phrase matches; synonyms must be supplied by the caller.",
"Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…"
]
}cURL
curl -i -X POST "https://www.brainiac.software/api/v1/seo-content/topic-coverage-score" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"draft": "Solar panels cost less after installation grants. Payback takes nine years.",
"topics": [
{
"id": "cost",
"phrases": [
"solar panel cost",
"price of solar panels"
]
},
{
"id": "payback",
"phrases": [
"payback period"
]
},
{
"id": "battery",
"phrases": [
"battery storage"
]
}
],
"partialThreshold": 0.5
}
JSONhttps://www.brainiac.software/api/v1/seo-content/rank-change-summary$0.03 USDCRank change winners and losers
Summarise winners, losers, new/lost keywords, top-3/top-10 crossings and volatility between rank snapshots.
Body
| Field | Required | Notes |
|---|---|---|
snapshots | Yes | array; Array |
segmentBy | No | array; Default: []; Array |
Request exampleJSON
{
"snapshots": [
{
"date": "2026-10-01",
"ranks": [
{
"keyword": "k1",
"position": 5,
"tags": [
"solar"
]
},
{
"keyword": "k2",
"position": 9
},
{
"keyword": "k4",
"position": 1
}
]
},
{
"date": "2026-11-01",
"ranks": [
{
"keyword": "k1",
"position": 2,
"tags": [
"solar"
]
},
{
"keyword": "k2",
"position": 12
},
{
"keyword": "k3",
"position": 8
},
{
"keyword": "k4",
"position": 1
}
]
}
],
"segmentBy": [
"device",
"location"
]
}Response exampleJSON
{
"segments": [
{
"segment": {
"device": null,
"location": null
},
"from": "2026-10-01",
"to": "2026-11-01",
"winners": [
{
"keyword": "k1",
"from": 5,
"to": 2,
"change": 3
}
],
"losers": [
{
"keyword": "k2",
"from": 9,
"to": 12,
"change": -3
}
],
"new": [
{
"keyword": "k3",
"to": 8
}
],
"lost": [],
"enteredTop3": [
"k1"
],
"leftTop3": [],
"enteredTop10": [
"k3"
],
"leftTop10": [
"k2"
],
"volatility": 2,
"byTag": {
"solar": {
"avgChange": 3
}
},
"datesUsed": [
"2026-10-01",
"2026-11-01"
]
}
],
"warnings": [],
"sources": [
{
"source": "Caller-supplied texts, keywords and rank snapshots processed locally",
"url": "https://www.brainiac.software/api/v1/seo-content",
"retrievedAt": "2026-11-14",
"status": "ok"
}
],
"limitations": [
"Compares first and last snapshot dates per segment only.",
"Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…"
]
}cURL
curl -i -X POST "https://www.brainiac.software/api/v1/seo-content/rank-change-summary" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"snapshots": [
{
"date": "2026-10-01",
"ranks": [
{
"keyword": "k1",
"position": 5,
"tags": [
"solar"
]
},
{
"keyword": "k2",
"position": 9
},
{
"keyword": "k4",
"position": 1
}
]
},
{
"date": "2026-11-01",
"ranks": [
{
"keyword": "k1",
"position": 2,
"tags": [
"solar"
]
},
{
"keyword": "k2",
"position": 12
},
{
"keyword": "k3",
"position": 8
},
{
"keyword": "k4",
"position": 1
}
]
}
],
"segmentBy": [
"device",
"location"
]
}
JSONhttps://www.brainiac.software/api/v1/seo-content/keyword-opportunity-score$0.03 USDCKeyword opportunity score
Rank keywords by click upside to a target position, weighted by difficulty using a disclosed formula.
Body
| Field | Required | Notes |
|---|---|---|
ctrCurve | Yes | array; Array |
keywords | Yes | array; Array |
targetPosition | No | integer; Default: 1 |
difficultyWeight | No | number; Default: 1 |
Request exampleJSON
{
"ctrCurve": [
0.3,
0.15,
0.1,
0.07,
0.05,
0.04,
0.03,
0.025,
0.02,
0.02
],
"keywords": [
{
"keyword": "solar panel cost",
"volume": 1000,
"difficulty": 45,
"position": 8
},
{
"keyword": "solar grants",
"volume": 500,
"difficulty": 20,
"position": 4
},
{
"keyword": "battery storage",
"volume": 250,
"difficulty": 10,
"position": 15
},
{
"keyword": "heat pump cost",
"volume": 0,
"difficulty": 30,
"position": 6
}
],
"targetPosition": 1,
"difficultyWeight": 1
}Response exampleJSON
{
"ranked": [
{
"keyword": "solar panel cost",
"potentialClicks": 275,
"score": 151.25
},
{
"keyword": "solar grants",
"potentialClicks": 115,
"score": 92
},
"…"
],
"formula": "volume × max(0, ctr(target) − ctr(current)) × (1 − difficulty/100)^w",
"sources": [
{
"source": "Caller-supplied texts, keywords and rank snapshots processed locally",
"url": "https://www.brainiac.software/api/v1/seo-content",
"retrievedAt": "2026-11-14",
"status": "ok"
}
],
"limitations": [
"CTR curve and difficulty are caller-supplied; score is a disclosed heuristic, not a traffic guarantee.",
"Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…"
]
}cURL
curl -i -X POST "https://www.brainiac.software/api/v1/seo-content/keyword-opportunity-score" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"ctrCurve": [
0.3,
0.15,
0.1,
0.07,
0.05,
0.04,
0.03,
0.025,
0.02,
0.02
],
"keywords": [
{
"keyword": "solar panel cost",
"volume": 1000,
"difficulty": 45,
"position": 8
},
{
"keyword": "solar grants",
"volume": 500,
"difficulty": 20,
"position": 4
},
{
"keyword": "battery storage",
"volume": 250,
"difficulty": 10,
"position": 15
},
{
"keyword": "heat pump cost",
"volume": 0,
"difficulty": 30,
"position": 6
}
],
"targetPosition": 1,
"difficultyWeight": 1
}
JSON