{"openapi":"3.1.0","info":{"title":"SEO Authority API","version":"0.1.0","description":"SEO authority and content intelligence computed from open-web data and deterministic methods.","contact":{"email":"clawdbotworker@gmail.com"},"x-guidance":"Use keyword-opportunity, competitor-gap, content-brief, site-audit, and internal-link-opportunities for decision-ready workflows. Use primitive endpoints for individual measurements. Scores are not Google metrics or ranking predictions. Live volume, CPC, SERP, and backlink fields are unavailable until a licensed provider is configured."},"servers":[{"url":"https://seo.forgemesh.io"}],"x-x402":{"network":"eip155:8453","payTo":"0xCc73d69a4D04fA41Afa3727C45140d51D71F615c"},"paths":{"/health":{"get":{"summary":"Health check","responses":{"200":{"description":"Healthy"}}}},"/openapi.json":{"get":{"summary":"OpenAPI document","responses":{"200":{"description":"This document"}}}},"/capabilities":{"get":{"summary":"Data-source and endpoint capability disclosure","responses":{"200":{"description":"Capabilities"}}}},"/.well-known/x402.json":{"get":{"summary":"x402 resource discovery document","responses":{"200":{"description":"x402 resources"}}}},"/.well-known/x402":{"get":{"summary":"x402 resource discovery document","responses":{"200":{"description":"x402 resources"}}}},"/v1/domain-authority":{"get":{"summary":"Measure one domain's open-web authority","parameters":[{"name":"domain","in":"query","required":true,"schema":{"type":"string"}}],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Successful result"},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"404":{"description":"Not covered by current index"}}}},"/v1/authority-compare":{"post":{"summary":"Compare authority for 2–20 domains","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["domains"],"properties":{"domains":{"type":"array","minItems":2,"maxItems":20,"items":{"type":"string"}}}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.02"}},"responses":{"200":{"description":"Successful result"},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"404":{"description":"Not covered by current index"}}}},"/v1/url-seo-score":{"post":{"summary":"Score supplied page HTML for deterministic on-page SEO checks","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url","html"],"properties":{"url":{"type":"string","format":"uri"},"html":{"type":"string","maxLength":512000}}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Successful result"},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"404":{"description":"Not covered by current index"}}}},"/v1/query-correct":{"get":{"summary":"Correct likely query spelling errors","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}}],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"responses":{"200":{"description":"Successful result"},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"404":{"description":"Not covered by current index"}}}},"/v1/query-expand":{"get":{"summary":"Generate related SEO query variants","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}}],"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"responses":{"200":{"description":"Successful result"},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"404":{"description":"Not covered by current index"}}}},"/v1/documents/search":{"get":{"summary":"Reserved document-search route (not currently sold)","responses":{"503":{"description":"Production document corpus is not loaded"}}}},"/v1/keyword-opportunity":{"post":{"summary":"Prioritize deterministic long-tail keyword opportunities","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"seed":{"type":"string"},"audience":{"type":"string"},"domain_authority_score":{"type":"number"}},"additionalProperties":false}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.05"}},"responses":{"200":{"description":"Successful result"},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"404":{"description":"Not covered by current index"}}}},"/v1/competitor-gap":{"post":{"summary":"Find content gaps in supplied competitor pages","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"object"},"competitors":{"type":"array","minItems":1,"maxItems":10}},"additionalProperties":false}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.10"}},"responses":{"200":{"description":"Successful result"},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"404":{"description":"Not covered by current index"}}}},"/v1/content-brief":{"post":{"summary":"Build an evidence-tagged SEO content brief","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"keyword":{"type":"string"},"competitor_pages":{"type":"array"},"site_pages":{"type":"array"}},"additionalProperties":false}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.10"}},"responses":{"200":{"description":"Successful result"},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"404":{"description":"Not covered by current index"}}}},"/v1/site-audit":{"post":{"summary":"Audit supplied site HTML","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"pages":{"type":"array","minItems":1,"maxItems":50}},"additionalProperties":false}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.15"}},"responses":{"200":{"description":"Successful result"},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"404":{"description":"Not covered by current index"}}}},"/v1/internal-link-opportunities":{"post":{"summary":"Find missing internal-link opportunities","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"pages":{"type":"array","minItems":1,"maxItems":50}},"additionalProperties":false}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.05"}},"responses":{"200":{"description":"Successful result"},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"404":{"description":"Not covered by current index"}}}}}}