{"openapi":"3.1.0","info":{"title":"SCOPE Research API","version":"0.1.0","description":"Source-backed web research and Python-powered data analysis API for AI agents using x402 payments.","contact":{"email":"scope.research.api@outlook.com"}},"paths":{"/answer":{"post":{"summary":"Web Answer with Sources","description":"Get a concise current answer backed by public web sources, key facts, citations, and a search timestamp.","x-payment-info":{"protocol":"x402","version":2,"network":"eip155:8453","networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":"USDC","amount":"20000","priceUsd":"$0.020"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["query"],"properties":{"query":{"type":"string","minLength":3,"maxLength":1000}}}}}},"responses":{"200":{"description":"Research completed successfully.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"service":{"type":"string"},"endpoint":{"type":"string"},"priceUsd":{"type":"string"},"status":{"type":"string"},"mock":{"type":"boolean"},"sources":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}},"400":{"description":"Invalid request input."},"402":{"description":"x402 payment required."},"502":{"description":"Upstream research provider error."},"503":{"description":"Research budget or service availability error."},"504":{"description":"Upstream research provider timeout."}}}},"/website-research":{"post":{"summary":"Website & Business Research","description":"Research a public website or business including offerings, positioning, public pricing, trust signals, recent mentions, and sources.","x-payment-info":{"protocol":"x402","version":2,"network":"eip155:8453","networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":"USDC","amount":"30000","priceUsd":"$0.030"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["url"],"properties":{"url":{"type":"string","format":"uri","maxLength":2048},"focus":{"type":"string","maxLength":300}}}}}},"responses":{"200":{"description":"Research completed successfully.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"service":{"type":"string"},"endpoint":{"type":"string"},"priceUsd":{"type":"string"},"status":{"type":"string"},"mock":{"type":"boolean"},"sources":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}},"400":{"description":"Invalid request input."},"402":{"description":"x402 payment required."},"502":{"description":"Upstream research provider error."},"503":{"description":"Research budget or service availability error."},"504":{"description":"Upstream research provider timeout."}}}},"/news-research":{"post":{"summary":"Current News Research & Timeline","description":"Research recent news using current public sources and return key developments, timeline, uncertainty, disagreements, and citations.","x-payment-info":{"protocol":"x402","version":2,"network":"eip155:8453","networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":"USDC","amount":"30000","priceUsd":"$0.030"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["query"],"properties":{"query":{"type":"string","minLength":3,"maxLength":1000},"since":{"type":"string","maxLength":40}}}}}},"responses":{"200":{"description":"Research completed successfully.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"service":{"type":"string"},"endpoint":{"type":"string"},"priceUsd":{"type":"string"},"status":{"type":"string"},"mock":{"type":"boolean"},"sources":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}},"400":{"description":"Invalid request input."},"402":{"description":"x402 payment required."},"502":{"description":"Upstream research provider error."},"503":{"description":"Research budget or service availability error."},"504":{"description":"Upstream research provider timeout."}}}},"/company-research":{"post":{"summary":"Company Research & Intelligence","description":"Research a company or business using current public sources including products, competitors, developments, risks, business facts, and citations.","x-payment-info":{"protocol":"x402","version":2,"network":"eip155:8453","networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":"USDC","amount":"40000","priceUsd":"$0.040"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["company"],"properties":{"company":{"type":"string","minLength":2,"maxLength":300},"domain":{"type":"string","maxLength":255},"ticker":{"type":"string","maxLength":20},"focus":{"type":"string","maxLength":300}}}}}},"responses":{"200":{"description":"Research completed successfully.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"service":{"type":"string"},"endpoint":{"type":"string"},"priceUsd":{"type":"string"},"status":{"type":"string"},"mock":{"type":"boolean"},"sources":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}},"400":{"description":"Invalid request input."},"402":{"description":"x402 payment required."},"502":{"description":"Upstream research provider error."},"503":{"description":"Research budget or service availability error."},"504":{"description":"Upstream research provider timeout."}}}},"/product-research":{"post":{"summary":"Product Research & Alternatives","description":"Research a product using public information and return facts, strengths, weaknesses, tradeoffs, price context, alternatives, and sources.","x-payment-info":{"protocol":"x402","version":2,"network":"eip155:8453","networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":"USDC","amount":"40000","priceUsd":"$0.040"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["product"],"properties":{"product":{"type":"string","minLength":2,"maxLength":300},"brand":{"type":"string","maxLength":200},"focus":{"type":"string","maxLength":300}}}}}},"responses":{"200":{"description":"Research completed successfully.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"service":{"type":"string"},"endpoint":{"type":"string"},"priceUsd":{"type":"string"},"status":{"type":"string"},"mock":{"type":"boolean"},"sources":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}},"400":{"description":"Invalid request input."},"402":{"description":"x402 payment required."},"502":{"description":"Upstream research provider error."},"503":{"description":"Research budget or service availability error."},"504":{"description":"Upstream research provider timeout."}}}},"/ecommerce-research":{"post":{"summary":"Ecommerce Store & Competitor Research","description":"Research a public ecommerce store or business including categories, positioning, pricing patterns, offers, policies, competitors, and sources.","x-payment-info":{"protocol":"x402","version":2,"network":"eip155:8453","networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":"USDC","amount":"40000","priceUsd":"$0.040"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["store"],"properties":{"store":{"type":"string","minLength":2,"maxLength":300},"url":{"type":"string","format":"uri","maxLength":2048},"focus":{"type":"string","maxLength":300}}}}}},"responses":{"200":{"description":"Research completed successfully.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"service":{"type":"string"},"endpoint":{"type":"string"},"priceUsd":{"type":"string"},"status":{"type":"string"},"mock":{"type":"boolean"},"sources":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}},"400":{"description":"Invalid request input."},"402":{"description":"x402 payment required."},"502":{"description":"Upstream research provider error."},"503":{"description":"Research budget or service availability error."},"504":{"description":"Upstream research provider timeout."}}}},"/research":{"post":{"summary":"Deep Multi-Source Web Research","description":"Perform deeper multi-source public web research with structured findings, conflicting evidence, uncertainty, citations, and source-backed synthesis.","x-payment-info":{"protocol":"x402","version":2,"network":"eip155:8453","networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":"USDC","amount":"50000","priceUsd":"$0.050"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["query"],"properties":{"query":{"type":"string","minLength":3,"maxLength":1000},"focus":{"type":"string","maxLength":300}}}}}},"responses":{"200":{"description":"Research completed successfully.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"service":{"type":"string"},"endpoint":{"type":"string"},"priceUsd":{"type":"string"},"status":{"type":"string"},"mock":{"type":"boolean"},"sources":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}},"400":{"description":"Invalid request input."},"402":{"description":"x402 payment required."},"502":{"description":"Upstream research provider error."},"503":{"description":"Research budget or service availability error."},"504":{"description":"Upstream research provider timeout."}}}},"/data-analysis":{"post":{"summary":"Python Data Analysis","description":"Analyze CSV, JSON, or structured text using OpenAI Code Interpreter for calculations, statistics, aggregation, anomaly detection, and evidence-backed findings.","x-payment-info":{"protocol":"x402","version":2,"network":"eip155:8453","networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":"USDC","amount":"70000","priceUsd":"$0.070"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["query","data"],"properties":{"query":{"type":"string","minLength":3,"maxLength":1000},"data":{"type":"string","minLength":1,"maxLength":200000,"description":"CSV, JSON, or structured text to analyze."},"format":{"type":"string","enum":["csv","json","text"]}}}}}},"responses":{"200":{"description":"Research completed successfully.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"service":{"type":"string"},"endpoint":{"type":"string"},"priceUsd":{"type":"string"},"status":{"type":"string"},"mock":{"type":"boolean"},"sources":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}},"400":{"description":"Invalid request input."},"402":{"description":"x402 payment required."},"502":{"description":"Upstream research provider error."},"503":{"description":"Research budget or service availability error."},"504":{"description":"Upstream research provider timeout."}}}},"/file-research":{"post":{"summary":"File Research","description":"Research uploaded documents using OpenAI File Search and return evidence-grounded answers from the supplied file.","x-payment-info":{"protocol":"x402","version":2,"network":"eip155:8453","networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":"USDC","amount":"30000","priceUsd":"$0.030"},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","additionalProperties":false,"required":["query","file"],"properties":{"query":{"type":"string","minLength":3,"maxLength":1000},"file":{"type":"string","format":"binary","description":"Document to research."}}}}}},"responses":{"200":{"description":"Research completed successfully.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"service":{"type":"string"},"endpoint":{"type":"string"},"priceUsd":{"type":"string"},"status":{"type":"string"},"mock":{"type":"boolean"},"sources":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}},"400":{"description":"Invalid request input."},"402":{"description":"x402 payment required."},"502":{"description":"Upstream research provider error."},"503":{"description":"Research budget or service availability error."},"504":{"description":"Upstream research provider timeout."}}}},"/embeddings":{"post":{"summary":"Text Embeddings","description":"Generate compact semantic vector embeddings from text using OpenAI text-embedding-3-small for search, similarity, clustering, and retrieval workflows.","x-payment-info":{"protocol":"x402","version":2,"network":"eip155:8453","networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":"USDC","amount":"3000","priceUsd":"$0.003"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["input"],"properties":{"input":{"oneOf":[{"type":"string","minLength":1,"maxLength":20000},{"type":"array","minItems":1,"maxItems":16,"items":{"type":"string","minLength":1,"maxLength":20000}}],"description":"Text or a small batch of texts to convert into semantic embeddings."}}}}}},"responses":{"200":{"description":"Research completed successfully.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"service":{"type":"string"},"endpoint":{"type":"string"},"priceUsd":{"type":"string"},"status":{"type":"string"},"mock":{"type":"boolean"},"sources":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}},"400":{"description":"Invalid request input."},"402":{"description":"x402 payment required."},"502":{"description":"Upstream research provider error."},"503":{"description":"Research budget or service availability error."},"504":{"description":"Upstream research provider timeout."}}}},"/compare":{"post":{"summary":"Evidence-Backed Research Comparison","description":"Compare two companies, products, technologies, services, or topics using explicit criteria, current public evidence, tradeoffs, and citations.","x-payment-info":{"protocol":"x402","version":2,"network":"eip155:8453","networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":"USDC","amount":"50000","priceUsd":"$0.050"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["left","right"],"properties":{"left":{"type":"string","minLength":2,"maxLength":300},"right":{"type":"string","minLength":2,"maxLength":300},"criteria":{"type":"array","minItems":1,"maxItems":6,"items":{"type":"string","minLength":1,"maxLength":200}}}}}}},"responses":{"200":{"description":"Research completed successfully.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"service":{"type":"string"},"endpoint":{"type":"string"},"priceUsd":{"type":"string"},"status":{"type":"string"},"mock":{"type":"boolean"},"sources":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}},"400":{"description":"Invalid request input."},"402":{"description":"x402 payment required."},"502":{"description":"Upstream research provider error."},"503":{"description":"Research budget or service availability error."},"504":{"description":"Upstream research provider timeout."}}}}}}