{"openapi":"3.1.0","info":{"title":"Technical SEO Audits API","version":"1.0.0","description":"Robots.txt tests, sitemap and hreflang validation, canonical and redirect audits, internal link graph, orphan detection, schema.org JSON-LD checks, log-file bot analysis, crawl depth, URL parameters, backlink anchors, disavow files, Core Web Vitals ratings and keyword cannibalization from caller-supplied files only. 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-technical/robots-txt-test":{"post":{"operationId":"test_urls_against_robots_txt","summary":"Test URLs against robots.txt","description":"Evaluate path access for a user-agent against a caller-supplied robots.txt using RFC 9309 longest-match rules.","tags":["seo-technical"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"robotsTxt":{"type":"string","maxLength":512000},"userAgent":{"type":"string","minLength":1,"maxLength":256},"urls":{"minItems":1,"maxItems":10000,"type":"array","items":{"type":"string","minLength":1,"maxLength":4096}}},"required":["robotsTxt","userAgent","urls"],"additionalProperties":false},"example":{"robotsTxt":"User-agent: *\nDisallow: /private/\nAllow: /private/public$\n","userAgent":"Googlebot","urls":["/private/x","/private/public"]}}}},"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":{"group":{"type":"string"},"results":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"allowed":{"type":"boolean"},"rule":{"type":"string"},"line":{"type":"number"}},"additionalProperties":true}},"sitemaps":{"type":"array","items":{}},"crawlDelay":{"type":"null"},"unknownDirectives":{"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":{"group":"*","results":[{"url":"/private/x","allowed":false,"rule":"Disallow: /private/","line":2},{"url":"/private/public","allowed":true,"rule":"Allow: /private/public$","line":3}],"sitemaps":[],"crawlDelay":null,"unknownDirectives":[],"sources":[{"source":"Caller-supplied robots.txt tested locally per RFC 9309","url":"https://www.brainiac.software/api/v1/seo-technical","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Rule matching follows RFC 9309 longest-match with Allow winning ties; Sitemap and Crawl-delay are reported only.","Pure computation on caller-supplied files/exports: no request-time crawl or third-party fetch.","…"]}}}},"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-technical/xml-sitemap-validate":{"post":{"operationId":"validate_a_sitemap_or_sitemap_index","summary":"Validate a sitemap or sitemap index","description":"Check sitemap URL counts, absolute locs, lastmod/changefreq/priority and size limits against the sitemaps.org protocol.","tags":["seo-technical"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"xml":{"type":"string","maxLength":55000000},"gzipBase64":{"anyOf":[{"type":"string","maxLength":55000000},{"type":"null"}]},"sitemapUrl":{"type":"string","format":"uri"}},"additionalProperties":false},"example":{"xml":"<?xml version='1.0'?><urlset xmlns='http://www.sitemaps.org/schemas/sitemap/0.9'><url><loc>https://example.com/</loc><lastmod>2026-11-14</lastmod><changefreq>daily</changefreq><priority>0.8</priority></url></urlset>","sitemapUrl":"https://example.com/sitemap.xml"}}}},"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":{"type":{"type":"string"},"urlCount":{"type":"number"},"bytes":{"type":"number"},"errors":{"type":"array","items":{}},"warnings":{"type":"array","items":{}},"duplicates":{"type":"number"},"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":{"type":"urlset","urlCount":1,"bytes":215,"errors":[],"warnings":[],"duplicates":0,"sources":[{"source":"Caller-supplied sitemap XML validated locally against sitemaps.org","url":"https://www.brainiac.software/api/v1/seo-technical","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Limits: 50,000 URLs and 52,428,800 uncompressed bytes per file; image/video/news namespaces are accepted and not valida…","Pure computation on caller-supplied files/exports: no request-time crawl or third-party fetch.","…"]}}}},"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-technical/hreflang-validate":{"post":{"operationId":"validate_an_hreflang_cluster","summary":"Validate an hreflang cluster","description":"Check BCP 47 codes against the IANA subtag registry and reciprocal return tags across caller-supplied page alternates.","tags":["seo-technical"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"pages":{"minItems":1,"maxItems":10000,"type":"array","items":{"type":"object","properties":{"url":{"type":"string","minLength":1,"maxLength":4096},"canonical":{"type":"string","minLength":1,"maxLength":4096},"alternates":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"hreflang":{"type":"string","minLength":1,"maxLength":64},"href":{"type":"string","minLength":1,"maxLength":4096}},"required":["hreflang","href"],"additionalProperties":false}}},"required":["url","alternates"],"additionalProperties":false}}},"required":["pages"],"additionalProperties":false},"example":{"pages":[{"url":"https://ex.com/en/","canonical":"https://ex.com/en/","alternates":[{"hreflang":"en","href":"https://ex.com/en/"},{"hreflang":"de-DE","href":"https://ex.com/de/"},{"hreflang":"x-default","href":"https://ex.com/"}]},{"url":"https://ex.com/de/","canonical":"https://ex.com/de/","alternates":[{"hreflang":"de-DE","href":"https://ex.com/de/"},{"hreflang":"en","href":"https://ex.com/en/"},{"hreflang":"x-default","href":"https://ex.com/"}]},{"url":"https://ex.com/","canonical":"https://ex.com/","alternates":[{"hreflang":"x-default","href":"https://ex.com/"},{"hreflang":"en","href":"https://ex.com/en/"},{"hreflang":"de-DE","href":"https://ex.com/de/"}]}]}}}},"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":{"errors":{"type":"array","items":{}},"warnings":{"type":"array","items":{}},"clusters":{"type":"number"},"normalisation":{"type":"object","properties":{"stripParams":{"type":"array","items":{"type":"string"}},"ignoreTrailingSlash":{"type":"boolean"}},"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":{"errors":[],"warnings":[],"clusters":1,"normalisation":{"stripParams":["utm_*","gclid","…"],"ignoreTrailingSlash":false},"sources":[{"source":"Caller-supplied hreflang clusters validated locally","url":"https://www.brainiac.software/api/v1/seo-technical","retrievedAt":"2026-11-14","status":"ok"},{"source":"IANA Language Subtag Registry","url":"https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry","retrievedAt":"2026-09-17","status":"ok"}],"limitations":["Codes must be x-default or BCP 47 language[-Script][-REGION] with IANA-registered subtags.","Pure computation on caller-supplied files/exports: no request-time crawl or third-party fetch.","…"]}}}},"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-technical/canonical-audit":{"post":{"operationId":"audit_canonical_tags_in_a_crawl_export","summary":"Audit canonical tags in a crawl export","description":"Find missing, multiple, chained, redirecting and noindex canonical targets inside a caller-supplied crawl export.","tags":["seo-technical"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"pages":{"minItems":1,"maxItems":100000,"type":"array","items":{"type":"object","properties":{"url":{"type":"string","minLength":1,"maxLength":4096},"status":{"type":"integer","minimum":100,"maximum":599},"canonicals":{"default":[],"maxItems":20,"type":"array","items":{"type":"string","maxLength":4096}},"noindex":{"default":false,"type":"boolean"},"redirectTo":{"anyOf":[{"type":"string","maxLength":4096},{"type":"null"}]}},"required":["url","status"],"additionalProperties":false}}},"required":["pages"],"additionalProperties":false},"example":{"pages":[{"url":"https://ex.com/a","status":200,"canonicals":["https://ex.com/b"]},{"url":"https://ex.com/b","status":200,"canonicals":["https://ex.com/b"]}]}}}},"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":{"issues":{"type":"array","items":{}},"summary":{"type":"object","properties":{},"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":{"issues":[],"summary":{},"sources":[{"source":"Caller-supplied crawl export audited for canonical issues","url":"https://www.brainiac.software/api/v1/seo-technical","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Canonical chains are followed up to 10 hops within the supplied export only.","Pure computation on caller-supplied files/exports: no request-time crawl or third-party fetch.","…"]}}}},"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-technical/redirect-chain-analyze":{"post":{"operationId":"analyse_redirect_chains_and_loops","summary":"Analyse redirect chains and loops","description":"Walk caller-supplied redirect hops for chains, loops, mixed permanent/temporary statuses and HTTPS-to-HTTP downgrades.","tags":["seo-technical"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"hops":{"minItems":1,"maxItems":100000,"type":"array","items":{"type":"object","properties":{"from":{"type":"string","minLength":1,"maxLength":4096},"to":{"type":"string","minLength":1,"maxLength":4096},"status":{"type":"integer","minimum":300,"maximum":399}},"required":["from","to","status"],"additionalProperties":false}}},"required":["hops"],"additionalProperties":false},"example":{"hops":[{"from":"http://ex.com/a","to":"https://ex.com/a","status":301},{"from":"https://ex.com/a","to":"https://ex.com/b","status":302}]}}}},"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":{"chains":{"type":"array","items":{"type":"object","properties":{"start":{"type":"string"},"path":{"type":"array","items":{"type":"string"}},"length":{"type":"number"},"final":{"type":"string"},"statuses":{"type":"array","items":{"type":"number"}},"issues":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}},"loops":{"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":{"chains":[{"start":"http://ex.com/a","path":["http://ex.com/a","https://ex.com/a","…"],"length":2,"final":"https://ex.com/b","statuses":[301,302],"issues":["chain","mixed_permanent_temporary"]}],"loops":[],"sources":[{"source":"Caller-supplied redirect hops analysed locally","url":"https://www.brainiac.software/api/v1/seo-technical","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Paths are capped at 20 hops; protocol-relative targets inherit the source scheme.","Pure computation on caller-supplied files/exports: no request-time crawl or third-party fetch.","…"]}}}},"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-technical/internal-link-graph":{"post":{"operationId":"internal_pagerank_and_click_depth","summary":"Internal PageRank and click depth","description":"Compute PageRank, in/out degree and BFS click depth from caller-supplied internal link edges.","tags":["seo-technical"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"edges":{"minItems":1,"maxItems":200000,"type":"array","items":{"type":"object","properties":{"from":{"type":"string","minLength":1,"maxLength":4096},"to":{"type":"string","minLength":1,"maxLength":4096},"nofollow":{"default":false,"type":"boolean"}},"required":["from","to"],"additionalProperties":false}},"start":{"type":"string","minLength":1,"maxLength":4096},"damping":{"default":0.85,"type":"number","exclusiveMinimum":0,"exclusiveMaximum":1},"excludeNofollow":{"default":true,"type":"boolean"}},"required":["edges","start"],"additionalProperties":false},"example":{"edges":[{"from":"/","to":"/a"},{"from":"/a","to":"/b"}],"start":"/","damping":0.85,"excludeNofollow":true}}}},"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":{"nodes":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"pagerank":{"type":"number"},"inDegree":{"type":"number"},"outDegree":{"type":"number"},"depth":{"type":"number"}},"additionalProperties":true}},"components":{"type":"number"},"iterations":{"type":"number"},"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":{"nodes":[{"url":"/","pagerank":0.18441678185487081,"inDegree":0,"outDegree":1,"depth":0},{"url":"/a","pagerank":0.3411710466111788,"inDegree":1,"outDegree":1,"depth":1},"…"],"components":1,"iterations":30,"sources":[{"source":"Caller-supplied internal link edges scored with PageRank and BFS depth","url":"https://www.brainiac.software/api/v1/seo-technical","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["PageRank uses damping with dangling-node redistribution; duplicate edges count once; L1 stop < 1e-9 or 200 iterations.","Pure computation on caller-supplied files/exports: no request-time crawl or third-party fetch.","…"]}}}},"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-technical/orphan-page-detect":{"post":{"operationId":"detect_orphan_and_unsitemap_pages","summary":"Detect orphan and unsitemap pages","description":"Compare normalised sitemap, crawl and analytics URL sets to find orphans, missing sitemap entries and no-traffic pages.","tags":["seo-technical"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"sitemapUrls":{"default":[],"maxItems":200000,"type":"array","items":{"type":"string","minLength":1,"maxLength":4096}},"crawledUrls":{"default":[],"maxItems":200000,"type":"array","items":{"type":"string","minLength":1,"maxLength":4096}},"analyticsUrls":{"default":[],"maxItems":200000,"type":"array","items":{"type":"string","minLength":1,"maxLength":4096}},"ignoreTrailingSlash":{"default":true,"type":"boolean"},"stripParams":{"default":["utm_*","gclid","fbclid","msclkid"],"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}}},"additionalProperties":false},"example":{"sitemapUrls":["/a","/b"],"crawledUrls":["/a"],"analyticsUrls":["/c"],"ignoreTrailingSlash":true}}}},"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":{"orphans":{"type":"array","items":{"type":"string"}},"notInSitemap":{"type":"array","items":{}},"noTraffic":{"type":"array","items":{"type":"string"}},"normalisation":{"type":"object","properties":{"ignoreTrailingSlash":{"type":"boolean"},"stripParams":{"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":{"orphans":["/b","/c"],"notInSitemap":[],"noTraffic":["/a"],"normalisation":{"ignoreTrailingSlash":true,"stripParams":["utm_*","gclid","…"]},"sources":[{"source":"Caller-supplied sitemap, crawl and analytics URL sets compared locally","url":"https://www.brainiac.software/api/v1/seo-technical","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Orphans = (sitemap ∪ analytics) − crawled after normalisation.","Pure computation on caller-supplied files/exports: no request-time crawl or third-party fetch.","…"]}}}},"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-technical/schema-org-validate":{"post":{"operationId":"validate_json_ld_against_schema_org","summary":"Validate JSON-LD against schema.org","description":"Check JSON-LD types and properties against a vendored schema.org Product/Offer vocabulary subset.","tags":["seo-technical"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"jsonld":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"array","items":{}}]}},"required":["jsonld"],"additionalProperties":false},"example":{"jsonld":{"@context":"https://schema.org","@type":"Product","name":"X","offers":{"@type":"Offer","price":"9.99","priceCurrency":"USD"}}}}}},"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":{"items":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"type":{"type":"string"},"errors":{"type":"array","items":{}},"warnings":{"type":"array","items":{}}},"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":{"items":[{"path":"$.offers","type":"Offer","errors":[],"warnings":[]},{"path":"$","type":"Product","errors":[],"warnings":[]}],"sources":[{"source":"Caller-supplied JSON-LD validated against vendored schema.org vocabulary subset","url":"https://www.brainiac.software/api/v1/seo-technical","retrievedAt":"2026-11-14","status":"ok"},{"source":"schema.org vocabulary (Product/Offer subset)","url":"https://schema.org/version/latest/schemaorg-current-https.jsonld","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Type and property domain/range checks use the bundled schema.org subset. Google rich-result requirements are not claime…","Pure computation on caller-supplied files/exports: no request-time crawl or third-party fetch.","…"]}}}},"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-technical/log-file-bot-analyze":{"post":{"operationId":"analyse_crawler_hits_in_an_access_log","summary":"Analyse crawler hits in an access log","description":"Classify bot user-agents in Combined or W3C logs and verify Googlebot hits against vendored IP ranges.","tags":["seo-technical"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"log":{"type":"string","maxLength":52428800},"format":{"default":"combined","type":"string","enum":["combined","w3c"]},"directoryDepth":{"default":1,"type":"integer","minimum":0,"maximum":20}},"required":["log"],"additionalProperties":false},"example":{"log":"66.249.66.1 - - [14/Nov/2026:10:00:00 +0000] \"GET /a HTTP/1.1\" 200 512 \"-\" \"Mozilla/5.0 (compatible; Googlebot/2.1; +http://www.google.com/bot.html)\"\\n","format":"combined","directoryDepth":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":{"bots":{"type":"array","items":{"type":"object","properties":{"bot":{"type":"string"},"hits":{"type":"number"},"verifiedHits":{"type":"number"},"spoofedHits":{"type":"number"},"statuses":{"type":"object","properties":{"200":{"type":"number"}},"additionalProperties":true},"topDirectories":{"type":"array","items":{"type":"object","properties":{"dir":{"type":"string"},"hits":{"type":"number"}},"additionalProperties":true}},"byDay":{"type":"object","properties":{"2026-11-14":{"type":"number"}},"additionalProperties":true}},"additionalProperties":true}},"parseErrors":{"type":"number"},"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":{"bots":[{"bot":"Googlebot","hits":1,"verifiedHits":1,"spoofedHits":0,"statuses":{"200":1},"topDirectories":[{"dir":"/a","hits":1}],"byDay":{"2026-11-14":1}}],"parseErrors":0,"sources":[{"source":"Caller-supplied access log analysed locally","url":"https://www.brainiac.software/api/v1/seo-technical","retrievedAt":"2026-11-14","status":"ok"},{"source":"Googlebot IP ranges","url":"https://developers.google.com/static/search/apis/ipranges/googlebot.json","retrievedAt":"2026-11-13","status":"ok"}],"limitations":["Googlebot verification uses vendored googlebot.json prefixes only; Bing ranges are not bundled.","Pure computation on caller-supplied files/exports: no request-time crawl or third-party fetch.","…"]}}}},"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-technical/crawl-depth-analyze":{"post":{"operationId":"click_depth_distribution_from_link_edges","summary":"Click-depth distribution from link edges","description":"Multi-source BFS depth distribution with too-deep important URLs and unreachable nodes from caller edges.","tags":["seo-technical"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"edges":{"minItems":1,"maxItems":200000,"type":"array","items":{"type":"object","properties":{"from":{"type":"string","minLength":1,"maxLength":4096},"to":{"type":"string","minLength":1,"maxLength":4096}},"required":["from","to"],"additionalProperties":false}},"startUrls":{"minItems":1,"maxItems":1000,"type":"array","items":{"type":"string","minLength":1,"maxLength":4096}},"important":{"default":[],"maxItems":10000,"type":"array","items":{"type":"string","minLength":1,"maxLength":4096}},"maxDepth":{"default":3,"type":"integer","minimum":0,"maximum":100}},"required":["edges","startUrls"],"additionalProperties":false},"example":{"edges":[{"from":"/","to":"/a"},{"from":"/a","to":"/b"},{"from":"/b","to":"/pricing"}],"startUrls":["/"],"important":["/pricing"],"maxDepth":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":{"distribution":{"type":"object","properties":{"0":{"type":"number"},"1":{"type":"number"},"2":{"type":"number"},"3":{"type":"number"}},"additionalProperties":true},"tooDeep":{"type":"array","items":{}},"unreachable":{"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":{"distribution":{"0":1,"1":1,"2":1,"3":1},"tooDeep":[],"unreachable":[],"sources":[{"source":"Caller-supplied link edges analysed for click depth","url":"https://www.brainiac.software/api/v1/seo-technical","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Depth is the minimum hop count over the supplied start URLs; no live crawl is performed.","Pure computation on caller-supplied files/exports: no request-time crawl or third-party fetch.","…"]}}}},"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-technical/url-parameter-audit":{"post":{"operationId":"audit_url_parameter_explosion","summary":"Audit URL parameter explosion","description":"Find parameter usage, tracking params and duplicate-content URL groups from a caller-supplied URL list.","tags":["seo-technical"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"urls":{"minItems":1,"maxItems":200000,"type":"array","items":{"type":"string","minLength":1,"maxLength":4096}},"trackingParams":{"default":["utm_source","utm_medium","utm_campaign","utm_term","utm_content","gclid","fbclid","msclkid"],"maxItems":200,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}}},"required":["urls"],"additionalProperties":false},"example":{"urls":["/s?b=2&a=1","/s?a=1&b=2","/s?utm_source=x"],"trackingParams":["utm_source","gclid"]}}}},"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":{"parameters":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"urls":{"type":"number"},"distinctValues":{"type":"number"}},"additionalProperties":true}},"combinations":{"type":"array","items":{"type":"object","properties":{"params":{"type":"array","items":{"type":"string"}},"urls":{"type":"number"}},"additionalProperties":true}},"tracking":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"urls":{"type":"number"}},"additionalProperties":true}},"duplicateGroups":{"type":"array","items":{"type":"object","properties":{"canonicalCandidate":{"type":"string"},"variants":{"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":{"parameters":[{"name":"a","urls":2,"distinctValues":1},{"name":"b","urls":2,"distinctValues":1}],"combinations":[{"params":["a","b"],"urls":2}],"tracking":[{"name":"utm_source","urls":1}],"duplicateGroups":[{"canonicalCandidate":"/s","variants":2}],"sources":[{"source":"Caller-supplied URL list audited for parameter explosion","url":"https://www.brainiac.software/api/v1/seo-technical","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Query parameters are decoded and sorted; fragments are ignored; tracking params are excluded from duplicate grouping ke…","Pure computation on caller-supplied files/exports: no request-time crawl or third-party fetch.","…"]}}}},"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-technical/backlink-anchor-profile":{"post":{"operationId":"backlink_anchor_and_referring_domain_profile","summary":"Backlink anchor and referring-domain profile","description":"Classify anchors, rel shares and referring-domain concentration (HHI) from a caller backlink export.","tags":["seo-technical"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"links":{"minItems":1,"maxItems":200000,"type":"array","items":{"type":"object","properties":{"source":{"type":"string","minLength":1,"maxLength":4096},"target":{"type":"string","minLength":1,"maxLength":4096},"anchor":{"default":"","type":"string","maxLength":2048},"rel":{"type":"string","maxLength":256}},"required":["source","target"],"additionalProperties":false}},"brandTerms":{"default":[],"maxItems":200,"type":"array","items":{"type":"string","minLength":1,"maxLength":128}},"moneyKeywords":{"default":[],"maxItems":500,"type":"array","items":{"type":"string","minLength":1,"maxLength":256}}},"required":["links"],"additionalProperties":false},"example":{"links":[{"source":"https://a.com/x","target":"https://ex.com/","anchor":"best shoes","rel":"nofollow"},{"source":"https://a.com/y","target":"https://ex.com/","anchor":"click","rel":"nofollow"},{"source":"https://b.com/z","target":"https://ex.com/","anchor":"best shoes"}],"brandTerms":["ExCo"],"moneyKeywords":["best shoes"]}}}},"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":{"anchors":{"type":"array","items":{"type":"object","properties":{"anchor":{"type":"string"},"count":{"type":"number"},"share":{"type":"number"},"class":{"type":"string"}},"additionalProperties":true}},"relShare":{"type":"object","properties":{"follow":{"type":"number"},"nofollow":{"type":"number"},"sponsored":{"type":"number"},"ugc":{"type":"number"}},"additionalProperties":true},"referringDomains":{"type":"number"},"topDomainShare":{"type":"number"},"hhi":{"type":"number"},"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":{"anchors":[{"anchor":"best shoes","count":2,"share":0.6666666666666666,"class":"exact_match"},{"anchor":"click","count":1,"share":0.3333333333333333,"class":"other"}],"relShare":{"follow":0.3333333333333333,"nofollow":0.6666666666666666,"sponsored":0,"ugc":0},"referringDomains":2,"topDomainShare":0.6666666666666666,"hhi":0.5555555555555556,"sources":[{"source":"Caller-supplied backlink export profiled locally","url":"https://www.brainiac.software/api/v1/seo-technical","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Referring domains use the host minus a leading www.; no public-suffix list is bundled.","Pure computation on caller-supplied files/exports: no request-time crawl or third-party fetch.","…"]}}}},"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-technical/disavow-file-build":{"post":{"operationId":"build_or_validate_a_google_disavow_file","summary":"Build or validate a Google disavow file","description":"Validate domain: and URL entries, dedupe, and emit a Google Search Console disavow .txt within documented limits.","tags":["seo-technical"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entries":{"default":[],"maxItems":100100,"type":"array","items":{"type":"string","minLength":1,"maxLength":2200}},"existingFile":{"anyOf":[{"type":"string","maxLength":2097152},{"type":"null"}]}},"additionalProperties":false},"example":{"entries":["domain:spam.com","https://bad.com/page"],"existingFile":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":{"file":{"type":"string"},"lines":{"type":"number"},"bytes":{"type":"number"},"errors":{"type":"array","items":{}},"removedDuplicates":{"type":"number"},"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":{"file":"domain:spam.com\nhttps://bad.com/page\n","lines":2,"bytes":37,"errors":[],"removedDuplicates":0,"sources":[{"source":"Caller-supplied disavow entries validated locally against Google disavow file rules","url":"https://www.brainiac.software/api/v1/seo-technical","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["One URL or domain:host per line; max 100,000 lines and 2 MB; UTF-8 text.","Pure computation on caller-supplied files/exports: no request-time crawl or third-party fetch.","…"]}}}},"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-technical/core-web-vitals-assess":{"post":{"operationId":"rate_p75_core_web_vitals","summary":"Rate p75 Core Web Vitals","description":"Rate caller-supplied p75 LCP/INP/CLS/FCP/TTFB against web.dev thresholds and rank URL groups by failing CWV.","tags":["seo-technical"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"groups":{"minItems":1,"maxItems":1000,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":256},"device":{"default":"mobile","type":"string","enum":["mobile","desktop"]},"p75":{"type":"object","properties":{"lcpMs":{"type":"number"},"inpMs":{"type":"number"},"cls":{"type":"number"},"fcpMs":{"type":"number"},"ttfbMs":{"type":"number"},"fidMs":{"type":"number"}},"additionalProperties":false}},"required":["name","p75"],"additionalProperties":false}}},"required":["groups"],"additionalProperties":false},"example":{"groups":[{"name":"/product/*","device":"mobile","p75":{"lcpMs":3100,"inpMs":180,"cls":0.05,"fcpMs":1700,"ttfbMs":900}}]}}}},"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":{"name":{"type":"string"},"ratings":{"type":"object","properties":{"lcp":{"type":"string"},"inp":{"type":"string"},"cls":{"type":"string"},"fcp":{"type":"string"},"ttfb":{"type":"string"}},"additionalProperties":true},"coreWebVitalsPass":{"type":"boolean"},"worstMetric":{"type":"string"}},"additionalProperties":true}},"ranking":{"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":{"groups":[{"name":"/product/*","ratings":{"lcp":"needs_improvement","inp":"good","cls":"good","fcp":"good","ttfb":"needs_improvement"},"coreWebVitalsPass":false,"worstMetric":"lcp"}],"ranking":["/product/*"],"sources":[{"source":"Caller-supplied p75 field metrics rated against web.dev thresholds","url":"https://www.brainiac.software/api/v1/seo-technical","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Pass requires LCP, INP and CLS all good. FCP and TTFB are rated but are not Core Web Vitals. FID is rejected.","Pure computation on caller-supplied files/exports: no request-time crawl or third-party fetch.","…"]}}}},"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-technical/keyword-cannibalization-detect":{"post":{"operationId":"detect_keyword_cannibalization","summary":"Detect keyword cannibalization","description":"Find Search Console queries where multiple pages compete on impressions and estimate lost clicks.","tags":["seo-technical"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"rows":{"minItems":1,"maxItems":200000,"type":"array","items":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":512},"page":{"type":"string","minLength":1,"maxLength":4096},"clicks":{"type":"number","minimum":0},"impressions":{"type":"number","minimum":0},"position":{"type":"number","minimum":0}},"required":["query","page","clicks","impressions","position"],"additionalProperties":false}},"minImpressions":{"default":100,"type":"number","minimum":0},"brandTerms":{"default":[],"maxItems":200,"type":"array","items":{"type":"string","minLength":1,"maxLength":128}},"minShare":{"default":0.1,"type":"number","exclusiveMinimum":0,"maximum":1}},"required":["rows"],"additionalProperties":false},"example":{"rows":[{"query":"red shoes","page":"/a","clicks":10,"impressions":600,"position":8.2},{"query":"red shoes","page":"/b","clicks":2,"impressions":400,"position":12.5}],"minImpressions":100,"brandTerms":["exco"],"minShare":0.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":{"queries":{"type":"array","items":{"type":"object","properties":{"query":{"type":"string"},"pages":{"type":"array","items":{"type":"object","properties":{"page":{"type":"string"},"impressionShare":{"type":"number"},"position":{"type":"number"},"clicks":{"type":"number"}},"additionalProperties":true}},"estimatedLostClicks":{"type":"number"}},"additionalProperties":true}},"excludedBrand":{"type":"number"},"excludedLowImpressions":{"type":"number"},"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":{"queries":[{"query":"red shoes","pages":[{"page":"/a","impressionShare":0.6,"position":8.2,"clicks":10},{"page":"/b","impressionShare":0.4,"position":12.5,"clicks":2}],"estimatedLostClicks":4.7}],"excludedBrand":0,"excludedLowImpressions":0,"sources":[{"source":"Caller-supplied Search Console rows analysed for keyword cannibalization","url":"https://www.brainiac.software/api/v1/seo-technical","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Lost clicks are an estimate: (total impressions × best page CTR) − total clicks, floored at 0.","Pure computation on caller-supplied files/exports: no request-time crawl or third-party fetch.","…"]}}}},"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":{}}}}}}}}