# Technical SEO Audits API > 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. Each paid operation uses a fixed USDC price on Base with the x402 exact scheme. Unpaid GET, HEAD, and POST return 402 payment terms (POST validates the body only after payment terms are satisfied). A request that carries payment-signature is not yet charged: settlement happens only after a successful (2xx) result. HTTP 4xx/5xx are not charged. Coverage bodies with status complete, partial, or failed all return HTTP 200 and are charged at the full listed price. Settled 2xx responses include a payment-response header; 4xx/5xx do not. Follow https://www.brainiac.software/agent-instructions.txt for install, payment pins, idempotency, and billing rules. - Product: https://www.brainiac.software/api/seo-technical - Docs: https://www.brainiac.software/api/seo-technical/docs - OpenAPI: https://www.brainiac.software/api/seo-technical/openapi.json - Contact: support@brainiac.software (https://www.brainiac.software/contact) ## Operations ### POST /api/v1/seo-technical/robots-txt-test $0.02 USDC. Evaluate path access for a user-agent against a caller-supplied robots.txt using RFC 9309 longest-match rules. Inputs: robotsTxt, userAgent, urls Docs: https://www.brainiac.software/api/seo-technical/docs#seo-technical-robots-txt-test Example request: ```json { "robotsTxt": "User-agent: *\nDisallow: /private/\nAllow: /private/public$\n", "userAgent": "Googlebot", "urls": [ "/private/x", "/private/public" ] } ``` Example response: ```json { "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.", "…" ] } ``` ### POST /api/v1/seo-technical/xml-sitemap-validate $0.03 USDC. Check sitemap URL counts, absolute locs, lastmod/changefreq/priority and size limits against the sitemaps.org protocol. Inputs: xml?, gzipBase64?, sitemapUrl? Docs: https://www.brainiac.software/api/seo-technical/docs#seo-technical-xml-sitemap-validate Example request: ```json { "xml": "https://example.com/2026-11-14daily0.8", "sitemapUrl": "https://example.com/sitemap.xml" } ``` Example response: ```json { "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.", "…" ] } ``` ### POST /api/v1/seo-technical/hreflang-validate $0.03 USDC. Check BCP 47 codes against the IANA subtag registry and reciprocal return tags across caller-supplied page alternates. Inputs: pages Docs: https://www.brainiac.software/api/seo-technical/docs#seo-technical-hreflang-validate Example request: ```json { "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/" } ] } ] } ``` Example response: ```json { "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.", "…" ] } ``` ### POST /api/v1/seo-technical/canonical-audit $0.03 USDC. Find missing, multiple, chained, redirecting and noindex canonical targets inside a caller-supplied crawl export. Inputs: pages Docs: https://www.brainiac.software/api/seo-technical/docs#seo-technical-canonical-audit Example request: ```json { "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" ] } ] } ``` Example response: ```json { "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.", "…" ] } ``` ### POST /api/v1/seo-technical/redirect-chain-analyze $0.02 USDC. Walk caller-supplied redirect hops for chains, loops, mixed permanent/temporary statuses and HTTPS-to-HTTP downgrades. Inputs: hops Docs: https://www.brainiac.software/api/seo-technical/docs#seo-technical-redirect-chain-analyze Example request: ```json { "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 } ] } ``` Example response: ```json { "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.", "…" ] } ``` ### POST /api/v1/seo-technical/internal-link-graph $0.04 USDC. Compute PageRank, in/out degree and BFS click depth from caller-supplied internal link edges. Inputs: edges, start, damping?, excludeNofollow? Docs: https://www.brainiac.software/api/seo-technical/docs#seo-technical-internal-link-graph Example request: ```json { "edges": [ { "from": "/", "to": "/a" }, { "from": "/a", "to": "/b" } ], "start": "/", "damping": 0.85, "excludeNofollow": true } ``` Example response: ```json { "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.", "…" ] } ``` ### POST /api/v1/seo-technical/orphan-page-detect $0.02 USDC. Compare normalised sitemap, crawl and analytics URL sets to find orphans, missing sitemap entries and no-traffic pages. Inputs: sitemapUrls?, crawledUrls?, analyticsUrls?, ignoreTrailingSlash?, stripParams? Docs: https://www.brainiac.software/api/seo-technical/docs#seo-technical-orphan-page-detect Example request: ```json { "sitemapUrls": [ "/a", "/b" ], "crawledUrls": [ "/a" ], "analyticsUrls": [ "/c" ], "ignoreTrailingSlash": true } ``` Example response: ```json { "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.", "…" ] } ``` ### POST /api/v1/seo-technical/schema-org-validate $0.03 USDC. Check JSON-LD types and properties against a vendored schema.org Product/Offer vocabulary subset. Inputs: jsonld Docs: https://www.brainiac.software/api/seo-technical/docs#seo-technical-schema-org-validate Example request: ```json { "jsonld": { "@context": "https://schema.org", "@type": "Product", "name": "X", "offers": { "@type": "Offer", "price": "9.99", "priceCurrency": "USD" } } } ``` Example response: ```json { "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.", "…" ] } ``` ### POST /api/v1/seo-technical/log-file-bot-analyze $0.04 USDC. Classify bot user-agents in Combined or W3C logs and verify Googlebot hits against vendored IP ranges. Inputs: log, format?, directoryDepth? Docs: https://www.brainiac.software/api/seo-technical/docs#seo-technical-log-file-bot-analyze Example request: ```json { "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 } ``` Example response: ```json { "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.", "…" ] } ``` ### POST /api/v1/seo-technical/crawl-depth-analyze $0.03 USDC. Multi-source BFS depth distribution with too-deep important URLs and unreachable nodes from caller edges. Inputs: edges, startUrls, important?, maxDepth? Docs: https://www.brainiac.software/api/seo-technical/docs#seo-technical-crawl-depth-analyze Example request: ```json { "edges": [ { "from": "/", "to": "/a" }, { "from": "/a", "to": "/b" }, { "from": "/b", "to": "/pricing" } ], "startUrls": [ "/" ], "important": [ "/pricing" ], "maxDepth": 3 } ``` Example response: ```json { "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.", "…" ] } ``` ### POST /api/v1/seo-technical/url-parameter-audit $0.02 USDC. Find parameter usage, tracking params and duplicate-content URL groups from a caller-supplied URL list. Inputs: urls, trackingParams? Docs: https://www.brainiac.software/api/seo-technical/docs#seo-technical-url-parameter-audit Example request: ```json { "urls": [ "/s?b=2&a=1", "/s?a=1&b=2", "/s?utm_source=x" ], "trackingParams": [ "utm_source", "gclid" ] } ``` Example response: ```json { "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.", "…" ] } ``` ### POST /api/v1/seo-technical/backlink-anchor-profile $0.03 USDC. Classify anchors, rel shares and referring-domain concentration (HHI) from a caller backlink export. Inputs: links, brandTerms?, moneyKeywords? Docs: https://www.brainiac.software/api/seo-technical/docs#seo-technical-backlink-anchor-profile Example request: ```json { "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" ] } ``` Example response: ```json { "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.", "…" ] } ``` ### POST /api/v1/seo-technical/disavow-file-build $0.02 USDC. Validate domain: and URL entries, dedupe, and emit a Google Search Console disavow .txt within documented limits. Inputs: entries?, existingFile? Docs: https://www.brainiac.software/api/seo-technical/docs#seo-technical-disavow-file-build Example request: ```json { "entries": [ "domain:spam.com", "https://bad.com/page" ], "existingFile": null } ``` Example response: ```json { "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.", "…" ] } ``` ### POST /api/v1/seo-technical/core-web-vitals-assess $0.02 USDC. Rate caller-supplied p75 LCP/INP/CLS/FCP/TTFB against web.dev thresholds and rank URL groups by failing CWV. Inputs: groups Docs: https://www.brainiac.software/api/seo-technical/docs#seo-technical-core-web-vitals-assess Example request: ```json { "groups": [ { "name": "/product/*", "device": "mobile", "p75": { "lcpMs": 3100, "inpMs": 180, "cls": 0.05, "fcpMs": 1700, "ttfbMs": 900 } } ] } ``` Example response: ```json { "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.", "…" ] } ``` ### POST /api/v1/seo-technical/keyword-cannibalization-detect $0.03 USDC. Find Search Console queries where multiple pages compete on impressions and estimate lost clicks. Inputs: rows, minImpressions?, brandTerms?, minShare? Docs: https://www.brainiac.software/api/seo-technical/docs#seo-technical-keyword-cannibalization-detect Example request: ```json { "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 } ``` Example response: ```json { "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.", "…" ] } ```