# Content & Keyword Analytics API
> TF-IDF term gaps, SERP content briefs, readability, near-duplicates, internal links, intent labels, lexical groups, difficulty, heading gaps, snippet widths, content decay, topic coverage, share of voice, rank changes and opportunity scores from caller-supplied texts and ranks.
Each paid operation uses a fixed USDC price on Base with the x402 exact scheme. Unpaid GET, HEAD, and POST return 402 payment terms (POST validates the body only after payment terms are satisfied). A request that carries payment-signature is not yet charged: settlement happens only after a successful (2xx) result. HTTP 4xx/5xx are not charged. Coverage bodies with status complete, partial, or failed all return HTTP 200 and are charged at the full listed price. Settled 2xx responses include a payment-response header; 4xx/5xx do not.
Follow https://www.brainiac.software/agent-instructions.txt for install, payment pins, idempotency, and billing rules.
- Product: https://www.brainiac.software/api/seo-content
- Docs: https://www.brainiac.software/api/seo-content/docs
- OpenAPI: https://www.brainiac.software/api/seo-content/openapi.json
- Contact: support@brainiac.software (https://www.brainiac.software/contact)
## Operations
### POST /api/v1/seo-content/tfidf-term-gap
$0.04 USDC. Find stemmed terms common among competitor pages but missing or under-used in a draft, ranked by TF-IDF gap.
Inputs: draft, competitors, language?, minDocFrequency?, limit?
Docs: https://www.brainiac.software/api/seo-content/docs#seo-content-tfidf-term-gap
Example request:
```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
}
```
Example response:
```json
{
"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.",
"…"
]
}
```
### POST /api/v1/seo-content/brief-from-serp-texts
$0.04 USDC. Build a content brief from caller-supplied top-ranking HTML: common headings, word-count target, questions and recommended TF-IDF terms.
Inputs: pages, language?, minHeadingShare?, termLimit?
Docs: https://www.brainiac.software/api/seo-content/docs#seo-content-brief-from-serp-texts
Example request:
```json
{
"pages": [
{
"url": "https://a.example/solar",
"html": "
How much do solar panels cost?
Are solar grants available?
Payback period
"
},
{
"url": "https://b.example/solar",
"html": "Solar panel costs
Solar Grants
Maintenance
"
},
{
"url": "https://c.example/solar",
"html": "Solar panel cost
Payback period
Our team
"
}
],
"language": "en",
"minHeadingShare": 0.5,
"termLimit": 30
}
```
Example response:
```json
{
"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…"
]
}
```
### POST /api/v1/seo-content/readability-score
$0.02 USDC. Compute Flesch Reading Ease, Flesch-Kincaid, Gunning Fog, SMOG and Coleman-Liau from caller text.
Inputs: text, language?
Docs: https://www.brainiac.software/api/seo-content/docs#seo-content-readability-score
Example request:
```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"
}
```
Example response:
```json
{
"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…"
]
}
```
### POST /api/v1/seo-content/near-duplicate-detect
$0.03 USDC. Cluster near-duplicate pages with Jaccard similarity on token shingles and connected-component clustering.
Inputs: pages, shingleSize?, threshold?
Docs: https://www.brainiac.software/api/seo-content/docs#seo-content-near-duplicate-detect
Example request:
```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
}
```
Example response:
```json
{
"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…"
]
}
```
### POST /api/v1/seo-content/internal-link-suggest
$0.04 USDC. Suggest internal links by unigram TF-IDF cosine similarity and extract exact or partial anchor text from target keywords.
Inputs: pages, existingLinks?, minSimilarity?, maxPerSource?
Docs: https://www.brainiac.software/api/seo-content/docs#seo-content-internal-link-suggest
Example request:
```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
}
```
Example response:
```json
{
"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…"
]
}
```
### POST /api/v1/seo-content/keyword-intent-classify
$0.02 USDC. Label keywords as navigational, transactional, commercial or informational from bundled English modifier rules and caller brands.
Inputs: keywords, brands?, language?
Docs: https://www.brainiac.software/api/seo-content/docs#seo-content-keyword-intent-classify
Example request:
```json
{
"keywords": [
"buy solar panels",
"best solar panels 2026",
"how do solar panels work",
"acme solar login",
"solar panels"
],
"brands": [
"acme solar"
],
"language": "en"
}
```
Example response:
```json
{
"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…"
]
}
```
### POST /api/v1/seo-content/keyword-group-lexical
$0.03 USDC. Group keywords that share the same Porter2 stem signature, optionally merging groups by SERP URL overlap.
Inputs: keywords, serps?, minSharedUrls?, maxGroupSize?
Docs: https://www.brainiac.software/api/seo-content/docs#seo-content-keyword-group-lexical
Example request:
```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
}
```
Example response:
```json
{
"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…"
]
}
```
### POST /api/v1/seo-content/keyword-difficulty-estimate
$0.02 USDC. Estimate keyword difficulty as 100 × mean of capped log referring-domain scores from the caller-supplied top results.
Inputs: keyword, results, referenceCap?, serpFeatures?
Docs: https://www.brainiac.software/api/seo-content/docs#seo-content-keyword-difficulty-estimate
Example request:
```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": []
}
```
Example response:
```json
{
"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…"
]
}
```
### POST /api/v1/seo-content/heading-outline-compare
$0.03 USDC. Compare a target H1–H6 outline with competitors and list common sections the target lacks.
Inputs: target, competitors, minShare?
Docs: https://www.brainiac.software/api/seo-content/docs#seo-content-heading-outline-compare
Example request:
```json
{
"target": {
"url": "/mine",
"html": "Solar panel costs
Battery storage
"
},
"competitors": [
{
"url": "A",
"html": "How much do solar panels cost?
Are solar grants available?
Payback period
"
},
{
"url": "B",
"html": "Solar panel costs
Solar Grants
Maintenance
"
},
{
"url": "C",
"html": "Solar panel cost
Payback period
Our team
"
}
],
"minShare": 0.5
}
```
Example response:
```json
{
"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…"
]
}
```
### POST /api/v1/seo-content/serp-snippet-preview
$0.02 USDC. Estimate title and meta description pixel widths with Liberation Sans advances and truncate at caller-chosen limits.
Inputs: title, description, titleFontPx?, descriptionFontPx?, titleMaxPx?, descriptionMaxPx?
Docs: https://www.brainiac.software/api/seo-content/docs#seo-content-serp-snippet-preview
Example request:
```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
}
```
Example response:
```json
{
"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…"
]
}
```
### POST /api/v1/seo-content/content-decay-detect
$0.03 USDC. Flag pages whose clicks or impressions show a statistically significant decline with Mann-Kendall, Sen slope and windowed percent change.
Inputs: series, period?, alpha?, minDropPct?, comparisonWindow?
Docs: https://www.brainiac.software/api/seo-content/docs#seo-content-content-decay-detect
Example request:
```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
}
```
Example response:
```json
{
"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…"
]
}
```
### POST /api/v1/seo-content/topic-coverage-score
$0.03 USDC. Score a draft against required subtopics with synonym phrases, listing covered, partial and missing topics.
Inputs: draft, topics, partialThreshold?
Docs: https://www.brainiac.software/api/seo-content/docs#seo-content-topic-coverage-score
Example request:
```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
}
```
Example response:
```json
{
"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…"
]
}
```
### POST /api/v1/seo-content/share-of-voice-calc
$0.03 USDC. Compute estimated clicks, visibility and share of voice per domain from rank snapshots, volumes and a caller-supplied CTR curve.
Inputs: ctrCurve, keywords
Docs: https://www.brainiac.software/api/seo-content/docs#seo-content-share-of-voice-calc
Example request:
```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,
"ranks": {
"a.com": 1,
"b.com": 3,
"c.com": 12
}
},
{
"keyword": "solar grants",
"volume": 500,
"ranks": {
"a.com": 4,
"b.com": 1
}
},
{
"keyword": "battery storage",
"volume": 250,
"ranks": {
"b.com": 2,
"c.com": 5
}
}
]
}
```
Example response:
```json
{
"domains": [
{
"domain": "a.com",
"estimatedClicks": 335,
"visibility": 0.638095,
"shareOfVoice": 0.527559
},
{
"domain": "b.com",
"estimatedClicks": 287.5,
"visibility": 0.547619,
"shareOfVoice": 0.452756
},
"…"
],
"maxClicks": 525,
"ties": [],
"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 is caller-supplied; no built-in default. Positions beyond the curve contribute 0.",
"Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…"
]
}
```
### POST /api/v1/seo-content/rank-change-summary
$0.03 USDC. Summarise winners, losers, new/lost keywords, top-3/top-10 crossings and volatility between rank snapshots.
Inputs: snapshots, segmentBy?
Docs: https://www.brainiac.software/api/seo-content/docs#seo-content-rank-change-summary
Example request:
```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"
]
}
```
Example response:
```json
{
"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…"
]
}
```
### POST /api/v1/seo-content/keyword-opportunity-score
$0.03 USDC. Rank keywords by click upside to a target position, weighted by difficulty using a disclosed formula.
Inputs: ctrCurve, keywords, targetPosition?, difficultyWeight?
Docs: https://www.brainiac.software/api/seo-content/docs#seo-content-keyword-opportunity-score
Example request:
```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
}
```
Example response:
```json
{
"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…"
]
}
```