{"openapi":"3.1.0","info":{"title":"Niche Discovery API","version":"0.1.0","description":"Submit market needs and inspect evidence-linked niche hypotheses."},"paths":{"/niche-discovery/v1/submissions":{"post":{"tags":["niche discovery"],"summary":"Submit","operationId":"submit_niche_discovery_v1_submissions_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Submission"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Submit Niche Discovery V1 Submissions Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/niche-discovery/v1/niches":{"get":{"tags":["niche discovery"],"summary":"List Niches","operationId":"list_niches_niche_discovery_v1_niches_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":150,"default":"","title":"Q"}},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Category"}},{"name":"sort","in":"query","required":false,"schema":{"enum":["recent","score"],"type":"string","default":"score","title":"Sort"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Niches Niche Discovery V1 Niches Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/niche-discovery/v1/niches/{niche_id}":{"get":{"tags":["niche discovery"],"summary":"Niche","operationId":"niche_niche_discovery_v1_niches__niche_id__get","parameters":[{"name":"niche_id","in":"path","required":true,"schema":{"type":"string","title":"Niche Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-niche-paid-call","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Niche-Paid-Call"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Niche Niche Discovery V1 Niches  Niche Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/niche-discovery/v1/niches/{niche_id}/preview":{"get":{"tags":["niche discovery"],"summary":"Niche Preview","operationId":"niche_preview_niche_discovery_v1_niches__niche_id__preview_get","parameters":[{"name":"niche_id","in":"path","required":true,"schema":{"type":"string","title":"Niche Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Niche Preview Niche Discovery V1 Niches  Niche Id  Preview Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/niche-discovery/v1/subscription/status":{"get":{"tags":["niche discovery"],"summary":"Subscription Status","operationId":"subscription_status_niche_discovery_v1_subscription_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Subscription Status Niche Discovery V1 Subscription Status Get"}}}}}}},"/niche-discovery/v1/subscription/checkout":{"post":{"tags":["niche discovery"],"summary":"Subscription Checkout","operationId":"subscription_checkout_niche_discovery_v1_subscription_checkout_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Subscription Checkout Niche Discovery V1 Subscription Checkout Post"}}}}}}},"/niche-discovery/v1/subscription/portal":{"post":{"tags":["niche discovery"],"summary":"Subscription Portal","operationId":"subscription_portal_niche_discovery_v1_subscription_portal_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Subscription Portal Niche Discovery V1 Subscription Portal Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/niche-discovery/v1/niches/{niche_id}/pay-per-call":{"get":{"operationId":"get_niche_pay_per_call","summary":"Pay USD 0.25 in Base USDC for one full niche evaluation","parameters":[{"name":"niche_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Full evaluation with gateway payment receipt"},"402":{"description":"x402/MPP payment challenge"}}}}},"components":{"schemas":{"AtomicFact":{"properties":{"statement":{"type":"string","title":"Statement"},"status":{"$ref":"#/components/schemas/VerificationStatus"},"confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Confidence"},"explanation":{"type":"string","title":"Explanation"},"evidenceIds":{"items":{"type":"string"},"type":"array","title":"Evidenceids"}},"additionalProperties":false,"type":"object","required":["statement","status","confidence","explanation","evidenceIds"],"title":"AtomicFact"},"CapabilitiesResponse":{"properties":{"service":{"type":"string","title":"Service"},"version":{"type":"string","title":"Version"},"capabilities":{"items":{"$ref":"#/components/schemas/Capability"},"type":"array","title":"Capabilities"}},"additionalProperties":false,"type":"object","required":["service","version","capabilities"],"title":"CapabilitiesResponse"},"Capability":{"properties":{"id":{"type":"string","title":"Id"},"summary":{"type":"string","title":"Summary"},"status":{"type":"string","title":"Status"},"method":{"type":"string","title":"Method"},"path":{"type":"string","title":"Path"}},"additionalProperties":false,"type":"object","required":["id","summary","status","method","path"],"title":"Capability"},"ClaimVerificationRequest":{"properties":{"claim":{"type":"string","maxLength":4000,"minLength":3,"title":"Claim"},"asOf":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Asof"},"jurisdiction":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Jurisdiction"},"freshnessHours":{"anyOf":[{"type":"integer","maximum":8760.0,"minimum":1.0},{"type":"null"}],"title":"Freshnesshours","default":168},"sourcePolicy":{"$ref":"#/components/schemas/SourcePolicy","default":"authoritative"},"minimumSources":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Minimumsources","default":2},"maxSources":{"type":"integer","maximum":20.0,"minimum":1.0,"title":"Maxsources","default":8},"allowedDomains":{"items":{"type":"string"},"type":"array","maxItems":100,"title":"Alloweddomains"},"blockedDomains":{"items":{"type":"string"},"type":"array","maxItems":100,"title":"Blockeddomains"},"includeConflicts":{"type":"boolean","title":"Includeconflicts","default":true},"language":{"type":"string","maxLength":35,"minLength":2,"title":"Language","default":"auto"}},"additionalProperties":false,"type":"object","required":["claim"],"title":"ClaimVerificationRequest"},"ClaimVerificationResult":{"properties":{"verificationId":{"type":"string","title":"Verificationid"},"claim":{"type":"string","title":"Claim"},"status":{"$ref":"#/components/schemas/VerificationStatus"},"observedAt":{"type":"string","format":"date-time","title":"Observedat"},"conclusion":{"type":"string","title":"Conclusion"},"atomicFacts":{"items":{"$ref":"#/components/schemas/AtomicFact"},"type":"array","title":"Atomicfacts"},"providerSources":{"items":{"$ref":"#/components/schemas/ProviderSource"},"type":"array","title":"Providersources"},"evidence":{"items":{"$ref":"#/components/schemas/Evidence"},"type":"array","title":"Evidence"},"snapshots":{"items":{"$ref":"#/components/schemas/EvidenceSnapshot"},"type":"array","title":"Snapshots"},"conflicts":{"items":{"$ref":"#/components/schemas/Conflict"},"type":"array","title":"Conflicts"},"limitations":{"items":{"type":"string"},"type":"array","title":"Limitations"},"provenance":{"$ref":"#/components/schemas/VerificationProvenance"}},"additionalProperties":false,"type":"object","required":["verificationId","claim","status","observedAt","conclusion","atomicFacts","evidence","conflicts","limitations","provenance"],"title":"ClaimVerificationResult"},"Conflict":{"properties":{"summary":{"type":"string","title":"Summary"},"evidenceIds":{"items":{"type":"string"},"type":"array","title":"Evidenceids"}},"additionalProperties":false,"type":"object","required":["summary","evidenceIds"],"title":"Conflict"},"ContactMessageRequest":{"properties":{"name":{"type":"string","maxLength":120,"minLength":2,"title":"Name"},"email":{"type":"string","maxLength":320,"minLength":3,"title":"Email"},"subject":{"type":"string","maxLength":160,"minLength":3,"title":"Subject","default":"General inquiry"},"message":{"type":"string","maxLength":4000,"minLength":20,"title":"Message"},"serviceId":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Serviceid"},"company":{"type":"string","maxLength":200,"title":"Company","default":""}},"type":"object","required":["name","email","message"],"title":"ContactMessageRequest"},"CustomerCreateRequest":{"properties":{"name":{"type":"string","maxLength":200,"minLength":1,"title":"Name"},"email":{"anyOf":[{"type":"string","maxLength":320},{"type":"null"}],"title":"Email"}},"type":"object","required":["name"],"title":"CustomerCreateRequest"},"Evidence":{"properties":{"id":{"type":"string","title":"Id"},"url":{"type":"string","title":"Url"},"title":{"type":"string","title":"Title"},"publisher":{"type":"string","title":"Publisher"},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publishedat"},"retrievedAt":{"type":"string","format":"date-time","title":"Retrievedat"},"excerpt":{"type":"string","title":"Excerpt"},"relationship":{"$ref":"#/components/schemas/EvidenceRelationship"},"sourceType":{"type":"string","title":"Sourcetype"},"qualityReason":{"type":"string","title":"Qualityreason"},"providerSourceMatched":{"type":"boolean","title":"Providersourcematched","default":false},"cited":{"type":"boolean","title":"Cited","default":false},"snapshotId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snapshotid"},"consulted":{"type":"boolean","title":"Consulted","default":false},"snapshotted":{"type":"boolean","title":"Snapshotted","default":false}},"additionalProperties":false,"type":"object","required":["id","url","title","publisher","publishedAt","retrievedAt","excerpt","relationship","sourceType","qualityReason"],"title":"Evidence"},"EvidenceRelationship":{"type":"string","enum":["supports","contradicts","context"],"title":"EvidenceRelationship"},"EvidenceSnapshot":{"properties":{"snapshotId":{"type":"string","title":"Snapshotid"},"requestedUrl":{"type":"string","title":"Requestedurl"},"finalUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Finalurl"},"retrievedAt":{"type":"string","format":"date-time","title":"Retrievedat"},"status":{"$ref":"#/components/schemas/SnapshotStatus"},"httpStatus":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Httpstatus"},"contentType":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contenttype"},"contentLength":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Contentlength"},"rawSha256":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rawsha256"},"normalizedSha256":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Normalizedsha256"},"failureReason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Failurereason"}},"additionalProperties":false,"type":"object","required":["snapshotId","requestedUrl","retrievedAt","status"],"title":"EvidenceSnapshot"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"LicenseRequest":{"properties":{"licenseNumber":{"type":"string","maxLength":8,"minLength":1,"title":"Licensenumber"}},"type":"object","required":["licenseNumber"],"title":"LicenseRequest"},"NicheDraft":{"properties":{"title":{"type":"string","maxLength":180,"minLength":8,"title":"Title"},"problem":{"type":"string","maxLength":2000,"minLength":30,"title":"Problem"},"buyer":{"type":"string","maxLength":180,"minLength":3,"title":"Buyer"},"category":{"type":"string","maxLength":80,"minLength":2,"title":"Category"},"solution_hypothesis":{"type":"string","maxLength":2000,"minLength":20,"title":"Solution Hypothesis"},"pain":{"type":"integer","maximum":5.0,"minimum":0.0,"title":"Pain"},"frequency":{"type":"integer","maximum":5.0,"minimum":0.0,"title":"Frequency"},"willingness_to_pay":{"type":"integer","maximum":5.0,"minimum":0.0,"title":"Willingness To Pay"},"reachable_buyers":{"type":"integer","maximum":5.0,"minimum":0.0,"title":"Reachable Buyers"},"feasibility":{"type":"integer","maximum":5.0,"minimum":0.0,"title":"Feasibility"},"competition_gap":{"type":"integer","maximum":5.0,"minimum":0.0,"title":"Competition Gap"},"evaluation_notes":{"type":"string","maxLength":4000,"minLength":30,"title":"Evaluation Notes"},"signal_ids":{"items":{"type":"string"},"type":"array","maxItems":100,"minItems":1,"title":"Signal Ids"},"publish":{"type":"boolean","title":"Publish","default":false}},"type":"object","required":["title","problem","buyer","category","solution_hypothesis","pain","frequency","willingness_to_pay","reachable_buyers","feasibility","competition_gap","evaluation_notes","signal_ids"],"title":"NicheDraft"},"ProviderSource":{"properties":{"sourceId":{"type":"string","title":"Sourceid"},"url":{"type":"string","title":"Url"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"provider":{"type":"string","title":"Provider","default":"openai_web_search"},"searchCallIds":{"items":{"type":"string"},"type":"array","title":"Searchcallids"},"actions":{"items":{"type":"string"},"type":"array","title":"Actions"},"queries":{"items":{"type":"string"},"type":"array","title":"Queries"},"evidenceIds":{"items":{"type":"string"},"type":"array","title":"Evidenceids"},"cited":{"type":"boolean","title":"Cited","default":false},"snapshotId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snapshotid"}},"additionalProperties":false,"type":"object","required":["sourceId","url"],"title":"ProviderSource"},"QuoteRequest":{"properties":{"tier":{"type":"string","title":"Tier","default":"standard"}},"type":"object","title":"QuoteRequest"},"SnapshotStatus":{"type":"string","enum":["captured","failed","blocked","too_large","unsupported"],"title":"SnapshotStatus"},"SourcePolicy":{"type":"string","enum":["official_only","authoritative","open_web"],"title":"SourcePolicy"},"StatusIncidentCreateRequest":{"properties":{"title":{"type":"string","maxLength":200,"minLength":3,"title":"Title"},"message":{"type":"string","maxLength":8000,"minLength":3,"title":"Message"},"severity":{"type":"string","title":"Severity"},"affectedComponents":{"items":{"type":"string"},"type":"array","maxItems":20,"minItems":1,"title":"Affectedcomponents"}},"type":"object","required":["title","message","severity","affectedComponents"],"title":"StatusIncidentCreateRequest"},"StatusIncidentUpdateRequest":{"properties":{"status":{"type":"string","title":"Status"},"message":{"type":"string","maxLength":8000,"minLength":3,"title":"Message"}},"type":"object","required":["status","message"],"title":"StatusIncidentUpdateRequest"},"StatusSubscriptionRequest":{"properties":{"channel":{"type":"string","title":"Channel"},"target":{"type":"string","maxLength":2000,"minLength":3,"title":"Target"},"verificationEmail":{"anyOf":[{"type":"string","maxLength":320},{"type":"null"}],"title":"Verificationemail"}},"type":"object","required":["channel","target"],"title":"StatusSubscriptionRequest"},"Submission":{"properties":{"kind":{"type":"string","enum":["complaint","suggestion","proposal"],"title":"Kind"},"text":{"type":"string","maxLength":3000,"minLength":25,"title":"Text"},"audience":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Audience"},"source_url":{"anyOf":[{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},{"type":"null"}],"title":"Source Url"},"company":{"type":"string","maxLength":150,"title":"Company","default":""}},"type":"object","required":["kind","text"],"title":"Submission"},"SupportMessageRequest":{"properties":{"message":{"type":"string","maxLength":8000,"minLength":2,"title":"Message"}},"type":"object","required":["message"],"title":"SupportMessageRequest"},"SupportTicketCreateRequest":{"properties":{"subject":{"type":"string","maxLength":160,"minLength":3,"title":"Subject"},"message":{"type":"string","maxLength":8000,"minLength":10,"title":"Message"},"serviceId":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Serviceid"},"orderId":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Orderid"},"priority":{"type":"string","title":"Priority","default":"normal"}},"type":"object","required":["subject","message"],"title":"SupportTicketCreateRequest"},"SupportTicketUpdateRequest":{"properties":{"status":{"type":"string","title":"Status"},"message":{"anyOf":[{"type":"string","maxLength":8000},{"type":"null"}],"title":"Message"}},"type":"object","required":["status"],"title":"SupportTicketUpdateRequest"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VerificationProvenance":{"properties":{"provider":{"type":"string","title":"Provider"},"model":{"type":"string","title":"Model"},"providerResponseId":{"type":"string","title":"Providerresponseid"},"searchedWeb":{"type":"boolean","title":"Searchedweb"},"consultedSourceCount":{"type":"integer","title":"Consultedsourcecount"},"citedSourceCount":{"type":"integer","title":"Citedsourcecount"},"providerSourceCount":{"type":"integer","title":"Providersourcecount","default":0},"matchedEvidenceCount":{"type":"integer","title":"Matchedevidencecount","default":0},"snapshottedSourceCount":{"type":"integer","title":"Snapshottedsourcecount","default":0},"webSearchCallCount":{"type":"integer","title":"Websearchcallcount","default":0},"inputTokens":{"type":"integer","title":"Inputtokens","default":0},"cachedInputTokens":{"type":"integer","title":"Cachedinputtokens","default":0},"outputTokens":{"type":"integer","title":"Outputtokens","default":0},"cacheHit":{"type":"boolean","title":"Cachehit","default":false}},"additionalProperties":false,"type":"object","required":["provider","model","providerResponseId","searchedWeb","consultedSourceCount","citedSourceCount"],"title":"VerificationProvenance"},"VerificationStatus":{"type":"string","enum":["confirmed","partially_confirmed","contradicted","insufficient_evidence","ambiguous"],"title":"VerificationStatus"}}}}