{"openapi":"3.1.0","info":{"title":"NameIntel API","version":"1.0.0","description":"Name intelligence API and MCP server. Scores brand names across domain, trademark, social, SEO, and AI findability (GEO). Pay-per-call via x402 micropayments — no signup, no API keys.","contact":{"name":"NameIntel","email":"todd@silverbackcto.com","url":"https://nameintel.io"},"termsOfService":"https://nameintel.io/terms"},"servers":[{"url":"https://api.nameintel.io"}],"paths":{"/api/v1/score":{"post":{"operationId":"score_full","summary":"Full name score","description":"Score a brand name across all five dimensions: domain availability, trademark risk, social handle availability, SEO keyword strength, and AI findability (GEO score). Returns composite score 0-100 with sub-scores, verdict, and risk assessment. Use this when evaluating, validating, or vetting a candidate business name, product name, or brand for launch.","tags":["scoring"],"x-x402-price":{"amount":"0.05","currency":"USDC"},"x-dimensions":["domain","trademark","social","seo","geo"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"name":{"type":"string","minLength":1,"maxLength":100},"tlds":{"type":"array","items":{"type":"string"}},"platforms":{"type":"array","items":{"type":"string"}},"niceClasses":{"type":"array","items":{"type":"string"}}}}}}},"responses":{"200":{"description":"Score result","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required (x402). Response body is a payment menu.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/score/basic":{"post":{"operationId":"score_basic","summary":"Basic name score (no GEO)","description":"Score a brand name across four dimensions: domain, trademark, social, and SEO. Excludes the GEO (AI findability) check for callers who do not need that signal or want a cheaper price point.","tags":["scoring"],"x-x402-price":{"amount":"0.02","currency":"USDC"},"x-dimensions":["domain","trademark","social","seo"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"name":{"type":"string","minLength":1,"maxLength":100},"tlds":{"type":"array","items":{"type":"string"}},"platforms":{"type":"array","items":{"type":"string"}},"niceClasses":{"type":"array","items":{"type":"string"}}}}}}},"responses":{"200":{"description":"Score result","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required (x402). Response body is a payment menu.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/check/domain":{"post":{"operationId":"check_domain","summary":"Domain availability check","description":"Check domain name availability and pricing across .com, .io, .ai, .app, .co, .dev, and other configured TLDs. Returns availability status and premium/auction detection for each extension. Use when an agent only needs to know whether a domain is takeable.","tags":["scoring"],"x-x402-price":{"amount":"0.01","currency":"USDC"},"x-dimensions":["domain"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"name":{"type":"string","minLength":1,"maxLength":100},"tlds":{"type":"array","items":{"type":"string"}},"platforms":{"type":"array","items":{"type":"string"}},"niceClasses":{"type":"array","items":{"type":"string"}}}}}}},"responses":{"200":{"description":"Score result","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required (x402). Response body is a payment menu.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/check/trademark":{"post":{"operationId":"check_trademark","summary":"USPTO trademark conflict check","description":"Search the USPTO trademark database for conflicts with a candidate brand name. Returns exact matches, similar marks, risk level, and relevant Nice classes. Use when an agent needs trademark clearance signal before recommending or registering a name.","tags":["scoring"],"x-x402-price":{"amount":"0.01","currency":"USDC"},"x-dimensions":["trademark"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"name":{"type":"string","minLength":1,"maxLength":100},"tlds":{"type":"array","items":{"type":"string"}},"platforms":{"type":"array","items":{"type":"string"}},"niceClasses":{"type":"array","items":{"type":"string"}}}}}}},"responses":{"200":{"description":"Score result","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required (x402). Response body is a payment menu.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/check/social":{"post":{"operationId":"check_social","summary":"Social handle availability check","description":"Verify social media handle / username availability across 12+ platforms including X/Twitter, Instagram, TikTok, LinkedIn, YouTube, GitHub, Facebook, Reddit, Pinterest, and Threads. Use when an agent needs to confirm a brand can claim consistent handles.","tags":["scoring"],"x-x402-price":{"amount":"0.01","currency":"USDC"},"x-dimensions":["social"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"name":{"type":"string","minLength":1,"maxLength":100},"tlds":{"type":"array","items":{"type":"string"}},"platforms":{"type":"array","items":{"type":"string"}},"niceClasses":{"type":"array","items":{"type":"string"}}}}}}},"responses":{"200":{"description":"Score result","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required (x402). Response body is a payment menu.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/check/geo":{"post":{"operationId":"check_geo","summary":"GEO / AI findability score","description":"Evaluate a brand name on AI findability — how likely it is to surface correctly in answers from ChatGPT, Perplexity, Claude, and Gemini. Scores entity collision, semantic distinctiveness, corpus saturation, and phonetic clarity. The only API that measures this dimension.","tags":["scoring"],"x-x402-price":{"amount":"0.03","currency":"USDC"},"x-dimensions":["geo"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"name":{"type":"string","minLength":1,"maxLength":100},"tlds":{"type":"array","items":{"type":"string"}},"platforms":{"type":"array","items":{"type":"string"}},"niceClasses":{"type":"array","items":{"type":"string"}}}}}}},"responses":{"200":{"description":"Score result","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required (x402). Response body is a payment menu.","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"x-payment":{"protocol":"x402","manifest":"/.well-known/x402"}}