{"openapi":"3.1.0","info":{"title":"Open Agent Search","description":"Free agent-oriented search API over the SSearch-owned ingested corpus, with OpenSearch relevance, background availability state, and privacy-safe aggregate trends.","version":"0.4.0"},"paths":{"/":{"get":{"summary":"Home","operationId":"home__get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health Health Get"}}}}}}},"/v1/agent/register":{"post":{"summary":"Register Agent","operationId":"register_agent_v1_agent_register_post","requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/RegisterRequest"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Register Agent V1 Agent Register Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/search":{"post":{"summary":"Search","operationId":"search_v1_search_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Search V1 Search Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/result-selected":{"post":{"summary":"Result Selected","operationId":"result_selected_v1_result_selected_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResultSelectedRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Result Selected V1 Result Selected Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/document/{document_id}":{"get":{"summary":"Get Document","operationId":"get_document_v1_document__document_id__get","parameters":[{"name":"document_id","in":"path","required":true,"schema":{"type":"string","title":"Document Id"}},{"name":"max_chars","in":"query","required":false,"schema":{"type":"integer","default":30000,"title":"Max Chars"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Document V1 Document  Document Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/context":{"post":{"summary":"Get Context","operationId":"get_context_v1_context_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContextRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Context V1 Context Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/fetch":{"post":{"summary":"Fetch Page","operationId":"fetch_page_v1_fetch_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FetchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Fetch Page V1 Fetch Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/search/documents":{"post":{"summary":"Search Documents","operationId":"search_documents_v1_search_documents_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentSearchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Search Documents V1 Search Documents Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/search/stream":{"post":{"summary":"Search Stream","operationId":"search_stream_v1_search_stream_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/search/plan":{"post":{"summary":"Search Plan","operationId":"search_plan_v1_search_plan_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Search Plan V1 Search Plan Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/search/backend":{"get":{"summary":"Search Backend","operationId":"search_backend_v1_search_backend_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Search Backend V1 Search Backend Get"}}}}}}},"/v1/sources":{"get":{"summary":"Sources","operationId":"sources_v1_sources_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Sources V1 Sources Get"}}}}}}},"/internal/mcp-auth":{"get":{"summary":"Mcp Auth","operationId":"mcp_auth_internal_mcp_auth_put","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"put":{"summary":"Mcp Auth","operationId":"mcp_auth_internal_mcp_auth_put","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"summary":"Mcp Auth","operationId":"mcp_auth_internal_mcp_auth_put","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"delete":{"summary":"Mcp Auth","operationId":"mcp_auth_internal_mcp_auth_put","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"options":{"summary":"Mcp Auth","operationId":"mcp_auth_internal_mcp_auth_put","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"patch":{"summary":"Mcp Auth","operationId":"mcp_auth_internal_mcp_auth_put","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/trends/rising":{"get":{"summary":"Trends Rising","operationId":"trends_rising_v1_trends_rising_get","parameters":[{"name":"country","in":"query","required":false,"schema":{"type":"string","default":"*","title":"Country"}},{"name":"region","in":"query","required":false,"schema":{"type":"string","default":"*","title":"Region"}},{"name":"hours","in":"query","required":false,"schema":{"type":"integer","default":168,"title":"Hours"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":25,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Trends Rising V1 Trends Rising Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/crawl/enqueue":{"post":{"summary":"Admin Crawl Enqueue","operationId":"admin_crawl_enqueue_v1_admin_crawl_enqueue_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrawlSeedRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Admin Crawl Enqueue V1 Admin Crawl Enqueue Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/sites":{"get":{"summary":"Admin Sites","operationId":"admin_sites_v1_admin_sites_get","parameters":[{"name":"active","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Active"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Admin Sites V1 Admin Sites Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/sites/{domain}/state":{"post":{"summary":"Admin Site State","operationId":"admin_site_state_v1_admin_sites__domain__state_post","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","title":"Domain"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SiteStateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Admin Site State V1 Admin Sites  Domain  State Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/stats":{"get":{"summary":"Admin Stats","operationId":"admin_stats_v1_admin_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Admin Stats V1 Admin Stats Get"}}}}}}}},"components":{"schemas":{"ContextRequest":{"properties":{"document_id":{"type":"string","maxLength":128,"minLength":8,"title":"Document Id"},"query":{"type":"string","maxLength":2000,"minLength":1,"title":"Query"},"max_chars":{"type":"integer","maximum":20000.0,"minimum":500.0,"title":"Max Chars","default":5000},"max_passages":{"type":"integer","maximum":8.0,"minimum":1.0,"title":"Max Passages","default":5}},"type":"object","required":["document_id","query"],"title":"ContextRequest"},"CrawlSeedRequest":{"properties":{"urls":{"items":{"type":"string"},"type":"array","maxItems":500,"minItems":1,"title":"Urls"},"priority":{"type":"integer","maximum":1000.0,"minimum":1.0,"title":"Priority","default":100}},"type":"object","required":["urls"],"title":"CrawlSeedRequest"},"DocumentSearchRequest":{"properties":{"query":{"type":"string","maxLength":2000,"minLength":1,"title":"Query"},"max_results":{"type":"integer","maximum":25.0,"minimum":1.0,"title":"Max Results","default":10},"promote":{"type":"boolean","title":"Promote","default":true}},"type":"object","required":["query"],"title":"DocumentSearchRequest"},"FetchRequest":{"properties":{"url":{"type":"string","maxLength":4000,"minLength":8,"title":"Url"},"archive_fallback":{"type":"boolean","title":"Archive Fallback","default":true},"max_chars":{"type":"integer","maximum":100000.0,"minimum":500.0,"title":"Max Chars","default":30000}},"type":"object","required":["url"],"title":"FetchRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"RegisterRequest":{"properties":{"label":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Label"}},"type":"object","title":"RegisterRequest"},"ResultSelectedRequest":{"properties":{"search_id":{"type":"string","maxLength":120,"minLength":8,"title":"Search Id"},"url":{"type":"string","maxLength":4000,"minLength":8,"title":"Url"}},"type":"object","required":["search_id","url"],"title":"ResultSelectedRequest"},"SearchRequest":{"properties":{"query":{"type":"string","maxLength":2000,"minLength":1,"title":"Query"},"max_results":{"type":"integer","maximum":25.0,"minimum":1.0,"title":"Max Results","default":10},"fresh":{"type":"boolean","title":"Fresh","default":false},"freshness_days":{"type":"integer","maximum":90.0,"minimum":1.0,"title":"Freshness Days","default":30},"engine":{"type":"string","pattern":"^(auto|faiss|opensearch|meili)$","title":"Engine","default":"auto"},"wait_for_coverage":{"type":"boolean","title":"Wait For Coverage","default":false}},"type":"object","required":["query"],"title":"SearchRequest"},"SiteStateRequest":{"properties":{"state":{"type":"string","pattern":"^(auto|active|inactive)$","title":"State"}},"type":"object","required":["state"],"title":"SiteStateRequest"},"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"}}}}