{"openapi":"3.1.0","info":{"title":"Concordance","description":"Concordance: one query surfaces where a topic appears across 18 independent, real-time data sources -- news, SEC filings, court opinions, academic papers, economic indicators, stock quotes, trade data, and government records -- each result citing its real source, never a black-box summary. Four tools: full-text search, time-series lookups, cross-category topic digests, and single-call company briefs correlating market data with filings and mentions. Refreshed on a schedule, not proxied live -- see /catalog for the full source list and live freshness.","version":"1.0.0"},"paths":{"/healthz":{"get":{"summary":"Healthz","operationId":"healthz_healthz_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Healthz Healthz Get"}}}}},"security":[]}},"/catalog":{"get":{"summary":"Catalog","operationId":"catalog_catalog_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Catalog Catalog Get"}}}}},"security":[]}},"/llms.txt":{"get":{"summary":"Llms Txt","operationId":"llms_txt_llms_txt_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}},"security":[]}},"/":{"get":{"summary":"Landing","operationId":"landing__get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}},"security":[]}},"/tools/search":{"post":{"tags":["search"],"summary":"Search Endpoint","operationId":"search_endpoint_tools_search_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/tools/series":{"post":{"tags":["series"],"summary":"Series Endpoint","operationId":"series_endpoint_tools_series_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SeriesRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SeriesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/tools/digest":{"post":{"tags":["digest"],"summary":"Digest Endpoint","description":"The cross-category synthesis endpoint: one call replaces manually\ncalling /tools/search once per category and merging results\nyourself. Deliberately NOT an LLM-generated summary -- pure\nstructured aggregation of real search hits, keeping the same zero-\nmarginal-cost model as the rest of this service (an LLM call here\nwould need its own paid API key and per-call cost, undermining the\nwhole \"free sources, free to run\" design).","operationId":"digest_endpoint_tools_digest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DigestRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DigestResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/tools/company-brief":{"post":{"tags":["company_brief"],"summary":"Company Brief Endpoint","description":"The cross-source correlation endpoint: joins market quotes (3\nproviders), SEC filings, and general mentions (news/academic/legal/\ndev-community) for one company in a single call -- something no\nsingle-source competitor in this space can offer, since it requires\nowning all the underlying sources already. Partial results are\nnormal and expected here (e.g. market data present but no recent\nfilings) -- this endpoint aggregates across inherently-optional\nsources, unlike /tools/series which is about exactly one source and\nwhere \"not synced yet\" is a meaningful 503 signal.","operationId":"company_brief_endpoint_tools_company_brief_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyBriefRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyBriefResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/tools/corroboration":{"post":{"tags":["corroboration"],"summary":"Corroboration Endpoint","description":"Is this claim independently corroborated across multiple unrelated\nsources, or does it trace back to a single origin? Groups matches by\nSOURCE (not category, unlike /tools/digest) so a caller can see exactly\nhow many independent outlets/agencies/publications back a claim, not\njust how many raw documents mention it -- the literal meaning of\n\"concordance\": where a claim is attested across a body of independently\nsourced texts.","operationId":"corroboration_endpoint_tools_corroboration_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CorroborationRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CorroborationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/tools/timeline":{"post":{"tags":["timeline"],"summary":"Timeline Endpoint","description":"How has coverage of this topic developed over time, across every\naggregated source? Chronologically ordered (oldest first), unlike\n/tools/search (relevance-ranked) or /tools/digest (grouped by\ncategory) -- for tracking a story's evolution or an emerging trend\nacross independently-sourced outlets.","operationId":"timeline_endpoint_tools_timeline_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimelineRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimelineResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"CompanyBriefRequest":{"properties":{"company":{"type":"string","title":"Company"},"per_section_limit":{"type":"integer","maximum":20.0,"minimum":1.0,"title":"Per Section Limit","default":5}},"type":"object","required":["company"],"title":"CompanyBriefRequest"},"CompanyBriefResponse":{"properties":{"company":{"type":"string","title":"Company"},"ticker":{"type":"string","title":"Ticker"},"cik":{"type":"string","title":"Cik"},"market_data":{"items":{"$ref":"#/components/schemas/MarketDataPoint"},"type":"array","title":"Market Data"},"recent_filings":{"items":{"$ref":"#/components/schemas/CompanyMention"},"type":"array","title":"Recent Filings"},"mentions":{"items":{"$ref":"#/components/schemas/CompanyMention"},"type":"array","title":"Mentions"}},"type":"object","required":["company","ticker","cik","market_data","recent_filings","mentions"],"title":"CompanyBriefResponse"},"CompanyMention":{"properties":{"source":{"type":"string","title":"Source"},"category":{"type":"string","title":"Category"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"content":{"type":"string","title":"Content"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"published_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Published At"}},"type":"object","required":["source","category","title","content","url","published_at"],"title":"CompanyMention"},"CorroborationRequest":{"properties":{"claim":{"type":"string","title":"Claim"},"since":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Since"},"raw_pull_limit":{"type":"integer","maximum":200.0,"minimum":1.0,"title":"Raw Pull Limit","default":50}},"type":"object","required":["claim"],"title":"CorroborationRequest"},"CorroborationResponse":{"properties":{"claim":{"type":"string","title":"Claim"},"distinct_source_count":{"type":"integer","title":"Distinct Source Count"},"total_matches":{"type":"integer","title":"Total Matches"},"corroboration_level":{"type":"string","title":"Corroboration Level"},"sources":{"items":{"$ref":"#/components/schemas/SourceMention"},"type":"array","title":"Sources"}},"type":"object","required":["claim","distinct_source_count","total_matches","corroboration_level","sources"],"title":"CorroborationResponse"},"DigestCategoryGroup":{"properties":{"category":{"type":"string","title":"Category"},"count":{"type":"integer","title":"Count"},"top_results":{"items":{"$ref":"#/components/schemas/DigestResultItem"},"type":"array","title":"Top Results"}},"type":"object","required":["category","count","top_results"],"title":"DigestCategoryGroup"},"DigestRequest":{"properties":{"topic":{"type":"string","title":"Topic"},"since":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Since"},"per_category_limit":{"type":"integer","maximum":20.0,"minimum":1.0,"title":"Per Category Limit","default":5}},"type":"object","required":["topic"],"title":"DigestRequest"},"DigestResponse":{"properties":{"topic":{"type":"string","title":"Topic"},"total_count":{"type":"integer","title":"Total Count"},"categories":{"items":{"$ref":"#/components/schemas/DigestCategoryGroup"},"type":"array","title":"Categories"}},"type":"object","required":["topic","total_count","categories"],"title":"DigestResponse"},"DigestResultItem":{"properties":{"source":{"type":"string","title":"Source"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"content":{"type":"string","title":"Content"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"published_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Published At"}},"type":"object","required":["source","title","content","url","published_at"],"title":"DigestResultItem"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"MarketDataPoint":{"properties":{"source":{"type":"string","title":"Source"},"observed_at":{"type":"string","title":"Observed At"},"value":{"type":"number","title":"Value"}},"type":"object","required":["source","observed_at","value"],"title":"MarketDataPoint"},"SearchRequest":{"properties":{"query":{"type":"string","title":"Query"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"since":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Since"},"limit":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Limit","default":20}},"type":"object","required":["query"],"title":"SearchRequest"},"SearchResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/SearchResultItem"},"type":"array","title":"Results"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["results","count"],"title":"SearchResponse"},"SearchResultItem":{"properties":{"source":{"type":"string","title":"Source"},"category":{"type":"string","title":"Category"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"content":{"type":"string","title":"Content"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"published_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Published At"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["source","category","title","content","url","published_at","metadata"],"title":"SearchResultItem"},"SeriesPoint":{"properties":{"observed_at":{"type":"string","title":"Observed At"},"value":{"type":"number","title":"Value"}},"type":"object","required":["observed_at","value"],"title":"SeriesPoint"},"SeriesRequest":{"properties":{"source":{"type":"string","title":"Source"},"series_id":{"type":"string","title":"Series Id"},"start":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start"},"end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End"}},"type":"object","required":["source","series_id"],"title":"SeriesRequest"},"SeriesResponse":{"properties":{"source":{"type":"string","title":"Source"},"series_id":{"type":"string","title":"Series Id"},"points":{"items":{"$ref":"#/components/schemas/SeriesPoint"},"type":"array","title":"Points"}},"type":"object","required":["source","series_id","points"],"title":"SeriesResponse"},"SourceMention":{"properties":{"source":{"type":"string","title":"Source"},"category":{"type":"string","title":"Category"},"count":{"type":"integer","title":"Count"},"top_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Top Title"},"top_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Top Url"},"top_published_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Top Published At"}},"type":"object","required":["source","category","count","top_title","top_url","top_published_at"],"title":"SourceMention"},"TimelineEntry":{"properties":{"published_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Published At"},"source":{"type":"string","title":"Source"},"category":{"type":"string","title":"Category"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"}},"type":"object","required":["published_at","source","category","title","url"],"title":"TimelineEntry"},"TimelineRequest":{"properties":{"topic":{"type":"string","title":"Topic"},"since":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Since"},"limit":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Limit","default":30}},"type":"object","required":["topic"],"title":"TimelineRequest"},"TimelineResponse":{"properties":{"topic":{"type":"string","title":"Topic"},"count":{"type":"integer","title":"Count"},"undated_count":{"type":"integer","title":"Undated Count"},"timeline":{"items":{"$ref":"#/components/schemas/TimelineEntry"},"type":"array","title":"Timeline"}},"type":"object","required":["topic","count","undated_count","timeline"],"title":"TimelineResponse"},"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"}}}}