{"openapi":"3.1.0","info":{"title":"Content & Keyword Analytics API","version":"1.0.0","description":"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. Paid with x402 exact USDC on Base. No account is required.","contact":{"email":"support@brainiac.software"},"x-guidance":"BRAINIAC.software is a pay-per-call API for software agents. No account or API key is required.\nPayment uses x402 with exact USDC on Base (8453). Each paid resource accepts POST for the call; unpaid GET/HEAD return the same 402 payment challenge for discovery.\nHow to call an operation:\n1. POST JSON matching the requestBody. An unpaid POST (including empty body) returns 402 payment terms before body validation.\n2. Compare 402 payTo, asset, and network with /api/v1/catalog and /.well-known/x402 — not only with the 402 itself.\n3. Pay and retry with payment-signature. Invalid JSON/schema after payment-signature returns 400 and is not charged. Settlement (a charge) only on 2xx. payment-signature attached ≠ charged.\nIdempotency-Key: 64 hex chars from 32 random bytes. Reuse only for the same operation and body (replays stored response, including status=partial). A new key runs a fresh call.\nIdempotency after errors: unpaid 402 does not store the key. Post-signature 402/503 release it (retry same key). Pre-reserve schema 400 does not store it. Other post-signature responses (2xx/4xx/5xx) are stored: same key+body replays; different body → 409. Stored 4xx/5xx replays are not a second charge. Prefer a new key after fixing a 4xx; after 5xx reuse the same key only for the stored error.\nPost-signature 402/503 include prior-payment-attempt (nonce, settled false|unknown). A facilitator 502 is SETTLEMENT_UNKNOWN (stored under the Idempotency-Key; cross-instance replay needs the shared store; may already be charged) — check USDC authorizationState(payer, nonce) on Base before re-signing.\nSettlement signal: settled 2xx include payment-response. 4xx/5xx do not. Do not book a cost from payment-signature alone.\nCoverage billing: HTTP 200 with status complete, partial, or failed is charged at the full listed price. Retrying missing checks needs a new settled call. 4xx/5xx are not charged.\nmissing_items.reason: timeout/rate_limited → one delayed retry (new key); upstream_down → after recovery; not_supported → never.\nInvariants: any missing_items ⇒ not status complete; sources[] is provenance only (source, url, retrievedAt), never success/error keyed by check.\nFree lookup: GET /api/v1/results/{result_id} returns stored coverage JSON (404 RESULT_NOT_FOUND if unknown/expired; not a 402). Prior-Result-Id sets replaces_result_id.\nOutputs are prechecks/drafts for human review — not official determinations, legal advice, or certified filings."},"servers":[{"url":"https://www.brainiac.software"}],"paths":{"/api/v1/seo-content/tfidf-term-gap":{"post":{"operationId":"tf_idf_term_gap_vs_competitor_pages","summary":"TF-IDF term gap vs competitor pages","description":"Find stemmed terms common among competitor pages but missing or under-used in a draft, ranked by TF-IDF gap.","tags":["seo-content"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"draft":{"type":"string","minLength":1,"maxLength":200000},"competitors":{"minItems":2,"maxItems":50,"type":"array","items":{"anyOf":[{"type":"string","minLength":1,"maxLength":200000},{"type":"object","properties":{"url":{"type":"string"},"html":{"type":"string","minLength":1,"maxLength":200000},"text":{"type":"string","maxLength":200000}},"required":["html"],"additionalProperties":false}]}},"language":{"default":"en","type":"string"},"minDocFrequency":{"default":2,"type":"integer","minimum":1,"maximum":9007199254740991},"limit":{"default":50,"type":"integer","minimum":1,"maximum":200}},"required":["draft","competitors"],"additionalProperties":false},"example":{"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}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"gaps":{"type":"array","items":{"type":"object","properties":{"term":{"type":"string"},"display":{"type":"string"},"competitorAvgTfidf":{"type":"number"},"draftTfidf":{"type":"number"},"gap":{"type":"number"},"docFrequency":{"type":"number"}},"additionalProperties":true}},"lowConfidence":{"type":"boolean"},"duplicatesIgnored":{"type":"array","items":{}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"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.","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/seo-content/brief-from-serp-texts":{"post":{"operationId":"content_brief_from_serp_page_texts","summary":"Content brief from SERP page texts","description":"Build a content brief from caller-supplied top-ranking HTML: common headings, word-count target, questions and recommended TF-IDF terms.","tags":["seo-content"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"pages":{"minItems":2,"maxItems":20,"type":"array","items":{"type":"object","properties":{"url":{"type":"string","minLength":1},"html":{"type":"string","minLength":1,"maxLength":200000}},"required":["url","html"],"additionalProperties":false}},"language":{"default":"en","type":"string"},"minHeadingShare":{"default":0.5,"type":"number","minimum":0,"maximum":1},"termLimit":{"default":30,"type":"integer","minimum":1,"maximum":100}},"required":["pages"],"additionalProperties":false},"example":{"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}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"wordCount":{"type":"object","properties":{"median":{"type":"number"},"min":{"type":"number"},"max":{"type":"number"}},"additionalProperties":true},"commonHeadings":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"share":{"type":"number"},"pages":{"type":"number"}},"additionalProperties":true}},"questions":{"type":"array","items":{"type":"string"}},"recommendedTerms":{"type":"array","items":{"type":"object","properties":{"term":{"type":"string"},"meanTfidf":{"type":"number"},"docFrequency":{"type":"number"}},"additionalProperties":true}},"duplicatesIgnored":{"type":"array","items":{}},"notes":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"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…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/seo-content/readability-score":{"post":{"operationId":"english_readability_metrics","summary":"English readability metrics","description":"Compute Flesch Reading Ease, Flesch-Kincaid, Gunning Fog, SMOG and Coleman-Liau from caller text.","tags":["seo-content"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":200000},"language":{"default":"en","type":"string"}},"required":["text"],"additionalProperties":false},"example":{"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"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"counts":{"type":"object","properties":{"sentences":{"type":"number"},"words":{"type":"number"},"syllables":{"type":"number"},"letters":{"type":"number"},"polysyllables":{"type":"number"}},"additionalProperties":true},"fleschReadingEase":{"type":"number"},"fleschKincaidGrade":{"type":"number"},"gunningFog":{"type":"number"},"smog":{"type":"number"},"colemanLiau":{"type":"number"},"avgSentenceLength":{"type":"number"},"avgSyllablesPerWord":{"type":"number"},"smogReliable":{"type":"boolean"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"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…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/seo-content/near-duplicate-detect":{"post":{"operationId":"near_duplicate_page_clustering","summary":"Near-duplicate page clustering","description":"Cluster near-duplicate pages with Jaccard similarity on token shingles and connected-component clustering.","tags":["seo-content"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"pages":{"minItems":2,"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"text":{"type":"string","maxLength":200000},"html":{"type":"string","maxLength":200000}},"required":["id"],"additionalProperties":false}},"shingleSize":{"default":3,"type":"integer","minimum":1,"maximum":10},"threshold":{"default":0.8,"type":"number","minimum":0,"maximum":1}},"required":["pages"],"additionalProperties":false},"example":{"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}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"pairs":{"type":"array","items":{"type":"object","properties":{"a":{"type":"string"},"b":{"type":"string"},"jaccard":{"type":"number"}},"additionalProperties":true}},"clusters":{"type":"array","items":{"type":"array","items":{"type":"string"}}},"singletons":{"type":"array","items":{"type":"string"}},"shingleSize":{"type":"number"},"excluded":{"type":"array","items":{}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"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…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/seo-content/internal-link-suggest":{"post":{"operationId":"internal_link_suggestions","summary":"Internal link suggestions","description":"Suggest internal links by unigram TF-IDF cosine similarity and extract exact or partial anchor text from target keywords.","tags":["seo-content"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"pages":{"minItems":2,"maxItems":2000,"type":"array","items":{"type":"object","properties":{"url":{"type":"string","minLength":1},"text":{"type":"string","maxLength":200000},"html":{"type":"string","maxLength":200000},"targetKeywords":{"default":[],"maxItems":20,"type":"array","items":{"type":"string","maxLength":200}}},"required":["url"],"additionalProperties":false}},"existingLinks":{"default":[],"type":"array","items":{"type":"array","prefixItems":[{"type":"string"},{"type":"string"}],"items":false,"minItems":2,"maxItems":2}},"minSimilarity":{"default":0.2,"type":"number","minimum":0,"maximum":1},"maxPerSource":{"default":5,"type":"integer","minimum":1,"maximum":50}},"required":["pages"],"additionalProperties":false},"example":{"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}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"suggestions":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"target":{"type":"string"},"similarity":{"type":"number"},"anchor":{"type":["string","null"]},"anchorType":{"type":["string","null"]}},"additionalProperties":true}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"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…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/seo-content/keyword-intent-classify":{"post":{"operationId":"rule_based_keyword_intent_labels","summary":"Rule-based keyword intent labels","description":"Label keywords as navigational, transactional, commercial or informational from bundled English modifier rules and caller brands.","tags":["seo-content"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"keywords":{"minItems":1,"maxItems":10000,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}},"brands":{"default":[],"maxItems":500,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}},"language":{"default":"en","type":"string"}},"required":["keywords"],"additionalProperties":false},"example":{"keywords":["buy solar panels","best solar panels 2026","how do solar panels work","acme solar login","solar panels"],"brands":["acme solar"],"language":"en"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"keyword":{"type":"string"},"intents":{"type":"array","items":{"type":"string"}},"reasons":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"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…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/seo-content/keyword-group-lexical":{"post":{"operationId":"lexical_keyword_grouping","summary":"Lexical keyword grouping","description":"Group keywords that share the same Porter2 stem signature, optionally merging groups by SERP URL overlap.","tags":["seo-content"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"keywords":{"minItems":1,"maxItems":20000,"type":"array","items":{"type":"string","minLength":1,"maxLength":500}},"serps":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"maxItems":10,"type":"array","items":{"type":"string","maxLength":2000}}},{"type":"null"}]},"minSharedUrls":{"default":3,"type":"integer","minimum":1,"maximum":10},"maxGroupSize":{"default":500,"type":"integer","minimum":1,"maximum":5000}},"required":["keywords"],"additionalProperties":false},"example":{"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}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"groups":{"type":"array","items":{"type":"object","properties":{"signature":{"type":"array","items":{"type":"string"}},"keywords":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}},"ungrouped":{"type":"array","items":{}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"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…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/seo-content/keyword-difficulty-estimate":{"post":{"operationId":"transparent_keyword_difficulty","summary":"Transparent keyword difficulty","description":"Estimate keyword difficulty as 100 × mean of capped log referring-domain scores from the caller-supplied top results.","tags":["seo-content"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"keyword":{"type":"string","minLength":1,"maxLength":500},"results":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"position":{"type":"integer","minimum":1,"maximum":10},"referringDomains":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["position","referringDomains"],"additionalProperties":false}},"referenceCap":{"default":1000,"type":"integer","minimum":1,"maximum":9007199254740991},"serpFeatures":{"default":[],"type":"array","items":{"type":"string"}}},"required":["keyword","results"],"additionalProperties":false},"example":{"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":[]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"difficulty":{"type":"number"},"difficultyExact":{"type":"number"},"components":{"type":"array","items":{"type":"number"}},"coverage":{"type":"number"},"formula":{"type":"string"},"serpFeatureCount":{"type":"number"},"lowConfidence":{"type":"boolean"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"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…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/seo-content/heading-outline-compare":{"post":{"operationId":"heading_outline_gap_analysis","summary":"Heading outline gap analysis","description":"Compare a target H1–H6 outline with competitors and list common sections the target lacks.","tags":["seo-content"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"target":{"type":"object","properties":{"url":{"type":"string","minLength":1},"html":{"type":"string","minLength":1,"maxLength":200000}},"required":["url","html"],"additionalProperties":false},"competitors":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"url":{"type":"string","minLength":1},"html":{"type":"string","minLength":1,"maxLength":200000}},"required":["url","html"],"additionalProperties":false}},"minShare":{"default":0.5,"type":"number","minimum":0,"maximum":1}},"required":["target","competitors"],"additionalProperties":false},"example":{"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}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"targetOutline":{"type":"array","items":{"type":"object","properties":{"level":{"type":"number"},"text":{"type":"string"}},"additionalProperties":true}},"missing":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"share":{"type":"number"},"competitors":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}},"targetOnly":{"type":"array","items":{"type":"string"}},"warnings":{"type":"array","items":{}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"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…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/seo-content/serp-snippet-preview":{"post":{"operationId":"serp_snippet_pixel_width_preview","summary":"SERP snippet pixel-width preview","description":"Estimate title and meta description pixel widths with Liberation Sans advances and truncate at caller-chosen limits.","tags":["seo-content"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"title":{"type":"string","maxLength":1000},"description":{"type":"string","maxLength":5000},"titleFontPx":{"default":20,"type":"number","minimum":8,"maximum":40},"descriptionFontPx":{"default":14,"type":"number","minimum":8,"maximum":40},"titleMaxPx":{"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"null"}]},"descriptionMaxPx":{"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"null"}]}},"required":["title","description"],"additionalProperties":false},"example":{"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}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"object","properties":{"chars":{"type":"number"},"widthPx":{"type":"number"},"fits":{"type":"boolean"},"truncatedAt":{"type":"number"},"truncated":{"type":"string"},"truncatedWidthPx":{"type":"number"}},"additionalProperties":true},"description":{"type":"object","properties":{"chars":{"type":"number"},"widthPx":{"type":"number"},"fits":{"type":"null"}},"additionalProperties":true},"estimate":{"type":"boolean"},"font":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"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…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/seo-content/content-decay-detect":{"post":{"operationId":"content_decay_mann_kendall_test","summary":"Content decay Mann-Kendall test","description":"Flag pages whose clicks or impressions show a statistically significant decline with Mann-Kendall, Sen slope and windowed percent change.","tags":["seo-content"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"series":{"minItems":1,"maxItems":5000,"type":"array","items":{"type":"object","properties":{"url":{"type":"string","minLength":1},"metric":{"default":"clicks","type":"string","minLength":1},"values":{"minItems":1,"maxItems":1000,"type":"array","items":{"type":"number","minimum":0}}},"required":["url","values"],"additionalProperties":false}},"period":{"anyOf":[{"type":"integer","minimum":2,"maximum":9007199254740991},{"type":"null"}]},"alpha":{"default":0.05,"type":"number","exclusiveMinimum":0,"maximum":0.5},"minDropPct":{"default":10,"type":"number","minimum":0},"comparisonWindow":{"default":3,"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["series"],"additionalProperties":false},"example":{"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}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"decaying":{"type":"boolean"},"test":{"type":"string"},"S":{"type":"number"},"varS":{"type":"number"},"z":{"type":"number"},"pValue":{"type":"number"},"senSlope":{"type":"number"},"changePct":{"type":"number"}},"additionalProperties":true}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"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…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/seo-content/topic-coverage-score":{"post":{"operationId":"topic_coverage_score","summary":"Topic coverage score","description":"Score a draft against required subtopics with synonym phrases, listing covered, partial and missing topics.","tags":["seo-content"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"draft":{"type":"string","minLength":1,"maxLength":200000},"topics":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"phrases":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":500}}},"required":["id","phrases"],"additionalProperties":false}},"partialThreshold":{"default":0.5,"type":"number","exclusiveMinimum":0,"exclusiveMaximum":1}},"required":["draft","topics"],"additionalProperties":false},"example":{"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}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"score":{"type":"number"},"covered":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"matchedPhrase":{"type":"string"}},"additionalProperties":true}},"partial":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"phrase":{"type":"string"},"matchedStems":{"type":"array","items":{"type":"string"}},"fraction":{"type":"number"}},"additionalProperties":true}},"missing":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"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…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/seo-content/share-of-voice-calc":{"post":{"operationId":"share_of_voice_from_ranks","summary":"Share of voice from ranks","description":"Compute estimated clicks, visibility and share of voice per domain from rank snapshots, volumes and a caller-supplied CTR curve.","tags":["seo-content"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ctrCurve":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"number","minimum":0,"maximum":1}},"keywords":{"minItems":1,"maxItems":50000,"type":"array","items":{"type":"object","properties":{"keyword":{"type":"string","minLength":1},"volume":{"type":"number","minimum":0},"ranks":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"integer","minimum":1,"maximum":9007199254740991}}},"required":["keyword","volume","ranks"],"additionalProperties":false}}},"required":["ctrCurve","keywords"],"additionalProperties":false},"example":{"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}}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"domains":{"type":"array","items":{"type":"object","properties":{"domain":{"type":"string"},"estimatedClicks":{"type":"number"},"visibility":{"type":"number"},"shareOfVoice":{"type":"number"}},"additionalProperties":true}},"maxClicks":{"type":"number"},"ties":{"type":"array","items":{}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"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…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/seo-content/rank-change-summary":{"post":{"operationId":"rank_change_winners_and_losers","summary":"Rank change winners and losers","description":"Summarise winners, losers, new/lost keywords, top-3/top-10 crossings and volatility between rank snapshots.","tags":["seo-content"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"snapshots":{"minItems":2,"maxItems":400,"type":"array","items":{"type":"object","properties":{"date":{"type":"string","minLength":1},"ranks":{"type":"array","items":{"type":"object","properties":{"keyword":{"type":"string","minLength":1},"position":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}]},"device":{"type":"string"},"location":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}}},"required":["keyword","position"],"additionalProperties":false}}},"required":["date","ranks"],"additionalProperties":false}},"segmentBy":{"default":[],"type":"array","items":{"type":"string","enum":["device","location"]}}},"required":["snapshots"],"additionalProperties":false},"example":{"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"]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"segments":{"type":"array","items":{"type":"object","properties":{"segment":{"type":"object","properties":{"device":{"type":"null"},"location":{"type":"null"}},"additionalProperties":true},"from":{"type":"string"},"to":{"type":"string"},"winners":{"type":"array","items":{"type":"object","properties":{"keyword":{"type":"string"},"from":{"type":"number"},"to":{"type":"number"},"change":{"type":"number"}},"additionalProperties":true}},"losers":{"type":"array","items":{"type":"object","properties":{"keyword":{"type":"string"},"from":{"type":"number"},"to":{"type":"number"},"change":{"type":"number"}},"additionalProperties":true}},"new":{"type":"array","items":{"type":"object","properties":{"keyword":{"type":"string"},"to":{"type":"number"}},"additionalProperties":true}},"lost":{"type":"array","items":{}},"enteredTop3":{"type":"array","items":{"type":"string"}},"leftTop3":{"type":"array","items":{}},"enteredTop10":{"type":"array","items":{"type":"string"}},"leftTop10":{"type":"array","items":{"type":"string"}},"volatility":{"type":"number"},"byTag":{"type":"object","properties":{"solar":{"type":"object","properties":{"avgChange":{"type":"number"}},"additionalProperties":true}},"additionalProperties":true},"datesUsed":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}},"warnings":{"type":"array","items":{}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"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…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/seo-content/keyword-opportunity-score":{"post":{"operationId":"keyword_opportunity_score","summary":"Keyword opportunity score","description":"Rank keywords by click upside to a target position, weighted by difficulty using a disclosed formula.","tags":["seo-content"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ctrCurve":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"number","minimum":0,"maximum":1}},"keywords":{"minItems":1,"maxItems":50000,"type":"array","items":{"type":"object","properties":{"keyword":{"type":"string","minLength":1},"volume":{"type":"number","minimum":0},"difficulty":{"type":"number","minimum":0,"maximum":100},"position":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}]}},"required":["keyword","volume","difficulty","position"],"additionalProperties":false}},"targetPosition":{"default":1,"type":"integer","minimum":1,"maximum":9007199254740991},"difficultyWeight":{"default":1,"type":"number","minimum":0}},"required":["ctrCurve","keywords"],"additionalProperties":false},"example":{"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}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"ranked":{"type":"array","items":{"type":"object","properties":{"keyword":{"type":"string"},"potentialClicks":{"type":"number"},"score":{"type":"number"},"flag":{"type":"string"}},"additionalProperties":true}},"formula":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"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…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}}},"components":{"schemas":{"ApiError":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}