{"openapi":"3.1.0","info":{"title":"MCP Market Russia","description":"Russian construction companies and house projects catalog for AI agents","version":"3.2.0"},"paths":{"/api/companies/search":{"get":{"summary":"Api Search Companies","description":"Search companies API for web frontend. Splits query into words for AND matching.","operationId":"api_search_companies_api_companies_search_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","default":"","title":"Q"}},{"name":"region","in":"query","required":false,"schema":{"type":"string","default":"","title":"Region"}},{"name":"category","in":"query","required":false,"schema":{"type":"string","default":"","title":"Category"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/companies/{company_id}":{"get":{"summary":"Api Get Company","description":"Get full company details with projects for web frontend.","operationId":"api_get_company_api_companies__company_id__get","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","title":"Company Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/":{"get":{"summary":"Root","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/company/{company_id}":{"get":{"summary":"Company Profile","description":"Public company page.\n\nOne of ~3 400 landing pages and the only surface Yandex/Google can rank, so\nit has to carry real content: the previous version rendered ~300 characters\nand no internal links, which reads as a doorway page.","operationId":"company_profile_company__company_id__get","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","title":"Company Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/health":{"get":{"summary":"Api V1 Health","description":"Public health endpoint at /api/v1/health (whitelisted in API_TOOL_ENDPOINTS).","operationId":"api_v1_health_api_v1_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/stats":{"get":{"summary":"Stats","operationId":"stats_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/dashboard/overview":{"get":{"summary":"Dashboard Overview","description":"Full overview stats for dashboard (30s cache + single-flight + threadpool).","operationId":"dashboard_overview_api_dashboard_overview_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/dashboard/data-completeness":{"get":{"summary":"Dashboard Data Completeness","description":"Data completeness percentages for progress bars.","operationId":"dashboard_data_completeness_api_dashboard_data_completeness_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/dashboard/recent-queries":{"get":{"summary":"Dashboard Recent Queries","description":"Last 20 agent queries.","operationId":"dashboard_recent_queries_api_dashboard_recent_queries_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/dashboard/categories":{"get":{"summary":"Dashboard Categories","operationId":"dashboard_categories_api_dashboard_categories_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/dashboard/regions":{"get":{"summary":"Dashboard Regions","operationId":"dashboard_regions_api_dashboard_regions_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/dashboard/top-companies":{"get":{"summary":"Dashboard Top Companies","operationId":"dashboard_top_companies_api_dashboard_top_companies_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/dashboard/materials":{"get":{"summary":"Dashboard Materials","operationId":"dashboard_materials_api_dashboard_materials_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/dashboard/queries-chart":{"get":{"summary":"Dashboard Queries Chart","operationId":"dashboard_queries_chart_api_dashboard_queries_chart_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/dashboard/popular-tools":{"get":{"summary":"Dashboard Popular Tools","operationId":"dashboard_popular_tools_api_dashboard_popular_tools_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/dashboard/companies":{"get":{"summary":"Dashboard Companies","description":"Filter companies by region and/or category for dashboard.","operationId":"dashboard_companies_api_dashboard_companies_get","parameters":[{"name":"region","in":"query","required":false,"schema":{"type":"string","default":"","title":"Region"}},{"name":"category","in":"query","required":false,"schema":{"type":"string","default":"","title":"Category"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/demo":{"get":{"summary":"Demo Page","operationId":"demo_page_demo_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/dashboard":{"get":{"summary":"Dashboard","operationId":"dashboard_dashboard_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/admin":{"get":{"summary":"Admin Panel","operationId":"admin_panel_admin_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/pay":{"get":{"summary":"Pay Page","operationId":"pay_page_pay_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/login":{"get":{"summary":"Login Page","operationId":"login_page_login_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/api/analytics/price-map":{"get":{"summary":"Api Price Map","description":"Price heatmap data by region.","operationId":"api_price_map_api_analytics_price_map_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/analytics/market-summary":{"get":{"summary":"Api Market Summary","description":"Full market summary for the dashboard.","operationId":"api_market_summary_api_analytics_market_summary_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/analytics/top-companies":{"get":{"summary":"Api Top Companies","description":"Get top-rated companies with filters.","operationId":"api_top_companies_api_analytics_top_companies_get","parameters":[{"name":"region","in":"query","required":false,"schema":{"type":"string","default":"","title":"Region"}},{"name":"category","in":"query","required":false,"schema":{"type":"string","default":"","title":"Category"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/analytics/price-tiers":{"get":{"summary":"Api Price Tiers","description":"Price tier distribution.","operationId":"api_price_tiers_api_analytics_price_tiers_get","parameters":[{"name":"region","in":"query","required":false,"schema":{"type":"string","default":"","title":"Region"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/pricing.html":{"get":{"summary":"Pricing Page","operationId":"pricing_page_pricing_html_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/pricing":{"get":{"summary":"Pricing Page","operationId":"pricing_page_pricing_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/api/register":{"post":{"tags":["Account"],"summary":"Register Api Key","description":"Register new API key","operationId":"register_api_key_api_register_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/leads/create":{"post":{"summary":"Create Lead","description":"Create a lead (requires API key)","operationId":"create_lead_api_leads_create_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/leads":{"get":{"summary":"Get Leads","description":"Admin: leads list (personal data). Requires X-Admin-Token.","operationId":"get_leads_api_leads_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string","default":"","title":"Status"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/keys/{key_id}/toggle":{"post":{"summary":"Toggle Api Key","description":"Toggle API key active status (admin only)","operationId":"toggle_api_key_api_keys__key_id__toggle_post","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"integer","title":"Key Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/keys":{"get":{"summary":"Get Api Keys","description":"Admin: API key owners and usage. Requires X-Admin-Token.","operationId":"get_api_keys_api_keys_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/usage/stats":{"get":{"summary":"Get Usage Stats","description":"Admin: billing usage statistics. Requires X-Admin-Token.","operationId":"get_usage_stats_api_usage_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/pricing":{"get":{"summary":"Get Pricing","description":"Return pricing tiers","operationId":"get_pricing_api_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/search/companies":{"get":{"tags":["Search (Free)"],"summary":"Api V1 Search Companies","description":"Search companies via REST API. Free tier.","operationId":"api_v1_search_companies_api_v1_search_companies_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","default":"","title":"Q"}},{"name":"region","in":"query","required":false,"schema":{"type":"string","default":"","title":"Region"}},{"name":"category","in":"query","required":false,"schema":{"type":"string","default":"","title":"Category"}},{"name":"min_rating","in":"query","required":false,"schema":{"type":"number","default":0,"title":"Min Rating"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/search/projects":{"get":{"tags":["Search (Free)"],"summary":"Api V1 Search Projects","description":"Search projects via REST API. Free tier.","operationId":"api_v1_search_projects_api_v1_search_projects_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","default":"","title":"Q"}},{"name":"region","in":"query","required":false,"schema":{"type":"string","default":"","title":"Region"}},{"name":"category","in":"query","required":false,"schema":{"type":"string","default":"","title":"Category"}},{"name":"min_area","in":"query","required":false,"schema":{"type":"number","default":0,"title":"Min Area"}},{"name":"max_area","in":"query","required":false,"schema":{"type":"number","default":0,"title":"Max Area"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/companies/{company_id}":{"get":{"tags":["Companies (Free)"],"summary":"Api V1 Get Company","description":"Get company details. Free tier.","operationId":"api_v1_get_company_api_v1_companies__company_id__get","parameters":[{"name":"company_id","in":"path","required":true,"schema":{"type":"string","title":"Company Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/categories":{"get":{"tags":["Market Data (Free)"],"summary":"Api V1 Categories","description":"List all categories. Free tier.","operationId":"api_v1_categories_api_v1_categories_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/regions":{"get":{"tags":["Market Data (Free)"],"summary":"Api V1 Regions","description":"List all regions. Free tier.","operationId":"api_v1_regions_api_v1_regions_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/stats":{"get":{"tags":["Market Data (Free)"],"summary":"Api V1 Stats","description":"General stats. Free tier.","operationId":"api_v1_stats_api_v1_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/analytics/market":{"get":{"tags":["Analytics (Starter+)"],"summary":"Api V1 Market Analytics","description":"Market analytics. Starter+ plan required.","operationId":"api_v1_market_analytics_api_v1_analytics_market_get","parameters":[{"name":"region","in":"query","required":false,"schema":{"type":"string","default":"","title":"Region"}},{"name":"category","in":"query","required":false,"schema":{"type":"string","default":"","title":"Category"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/analytics/best-companies":{"get":{"tags":["Analytics (Starter+)"],"summary":"Api V1 Best Companies","description":"Find best companies. Starter+ plan required.","operationId":"api_v1_best_companies_api_v1_analytics_best_companies_get","parameters":[{"name":"region","in":"query","required":false,"schema":{"type":"string","default":"","title":"Region"}},{"name":"category","in":"query","required":false,"schema":{"type":"string","default":"","title":"Category"}},{"name":"sort_by","in":"query","required":false,"schema":{"type":"string","default":"rating","title":"Sort By"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/analytics/price-comparison":{"get":{"tags":["Analytics (Starter+)"],"summary":"Api V1 Price Comparison","description":"Price comparison analytics. Starter+ plan required.","operationId":"api_v1_price_comparison_api_v1_analytics_price_comparison_get","parameters":[{"name":"region","in":"query","required":false,"schema":{"type":"string","default":"","title":"Region"}},{"name":"category","in":"query","required":false,"schema":{"type":"string","default":"","title":"Category"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/analytics/report":{"get":{"tags":["Analytics (Starter+)"],"summary":"Api Analytics Report","description":"Comprehensive market analytics report (Starter+)","operationId":"api_analytics_report_api_v1_analytics_report_get","parameters":[{"name":"region","in":"query","required":false,"schema":{"type":"string","title":"Region"}},{"name":"category","in":"query","required":false,"schema":{"type":"string","title":"Category"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/compare":{"get":{"tags":["Market Data (Free)"],"summary":"Api V1 Compare","description":"Compare companies by IDs (comma-separated). Free tier.","operationId":"api_v1_compare_api_v1_compare_get","parameters":[{"name":"ids","in":"query","required":false,"schema":{"type":"string","default":"","title":"Ids"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/docs":{"get":{"tags":["Market Data (Free)"],"summary":"Api V1 Docs","description":"REST API documentation.","operationId":"api_v1_docs_api_v1_docs_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/ai/reviews":{"get":{"tags":["AI Tools (Pro+)"],"summary":"Api V1 Ai Reviews","description":"AI-анализ отзывов компании. Pro tier.","operationId":"api_v1_ai_reviews_api_v1_ai_reviews_get","parameters":[{"name":"company_id","in":"query","required":false,"schema":{"type":"string","default":"","title":"Company Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/ai/recommend":{"get":{"tags":["AI Tools (Pro+)"],"summary":"Api V1 Ai Recommend","description":"AI-подбор подрядчиков. Pro tier.","operationId":"api_v1_ai_recommend_api_v1_ai_recommend_get","parameters":[{"name":"region","in":"query","required":false,"schema":{"type":"string","default":"","title":"Region"}},{"name":"category","in":"query","required":false,"schema":{"type":"string","default":"строительство","title":"Category"}},{"name":"budget","in":"query","required":false,"schema":{"type":"number","default":0,"title":"Budget"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":5,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/ai/estimate":{"get":{"tags":["AI Tools (Pro+)"],"summary":"Api V1 Ai Estimate","description":"AI-оценка стоимости проекта. Pro tier.","operationId":"api_v1_ai_estimate_api_v1_ai_estimate_get","parameters":[{"name":"area","in":"query","required":false,"schema":{"type":"number","default":100,"title":"Area"}},{"name":"category","in":"query","required":false,"schema":{"type":"string","default":"строительство","title":"Category"}},{"name":"region","in":"query","required":false,"schema":{"type":"string","default":"","title":"Region"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/ai/trends":{"get":{"tags":["AI Tools (Pro+)"],"summary":"Api V1 Ai Trends","description":"AI-анализ трендов рынка. Pro tier.","operationId":"api_v1_ai_trends_api_v1_ai_trends_get","parameters":[{"name":"region","in":"query","required":false,"schema":{"type":"string","default":"","title":"Region"}},{"name":"period","in":"query","required":false,"schema":{"type":"string","default":"month","title":"Period"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/ai/deep-profile":{"get":{"tags":["AI Tools (Pro+)"],"summary":"Api V1 Ai Deep Profile","description":"Глубокий AI-профиль компании. Pro tier.","operationId":"api_v1_ai_deep_profile_api_v1_ai_deep_profile_get","parameters":[{"name":"company_id","in":"query","required":false,"schema":{"type":"string","default":"","title":"Company Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/ai/region-compare":{"get":{"tags":["AI Tools (Pro+)"],"summary":"Api V1 Ai Region Compare","description":"AI-сравнение регионов. Pro tier.","operationId":"api_v1_ai_region_compare_api_v1_ai_region_compare_get","parameters":[{"name":"regions","in":"query","required":false,"schema":{"type":"string","default":"","title":"Regions"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/payments/create":{"post":{"summary":"Create Payment","description":"Create a new crypto payment","operationId":"create_payment_api_payments_create_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/payments/{payment_id}":{"get":{"summary":"Get Payment Status","description":"Check payment status","operationId":"get_payment_status_api_payments__payment_id__get","parameters":[{"name":"payment_id","in":"path","required":true,"schema":{"type":"string","title":"Payment Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/payments/{payment_id}/confirm":{"post":{"summary":"Confirm Payment","description":"Admin: confirm payment and create API key. Requires X-Admin-Token.","operationId":"confirm_payment_api_payments__payment_id__confirm_post","parameters":[{"name":"payment_id","in":"path","required":true,"schema":{"type":"string","title":"Payment Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/payments":{"get":{"summary":"List Payments","description":"Admin: list all payments. Requires X-Admin-Token.","operationId":"list_payments_api_payments_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/dashboard/stats":{"get":{"summary":"Dashboard Stats Alias","description":"Alias for dashboard stat cards. Reuses overview + adds tools=21.","operationId":"dashboard_stats_alias_api_dashboard_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/dashboard/completeness":{"get":{"summary":"Dashboard Completeness Alias","description":"Alias: transform data-completeness to {fields: [{name, percentage}, ...]}.","operationId":"dashboard_completeness_alias_api_dashboard_completeness_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/dashboard/requests":{"get":{"summary":"Dashboard Requests Alias","description":"Alias: transform recent-queries to [{timestamp,endpoint,status,duration},...].","operationId":"dashboard_requests_alias_api_dashboard_requests_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/smart-match":{"get":{"tags":["Market Data (Free!)"],"summary":"Api Smart Match","description":"Natural-language Russian brief -> parsed filters + top-N contractors.","operationId":"api_smart_match_api_v1_smart_match_get","parameters":[{"name":"brief","in":"query","required":true,"schema":{"type":"string","title":"Brief"}},{"name":"top_n","in":"query","required":false,"schema":{"type":"integer","default":3,"title":"Top N"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/quickstart":{"get":{"summary":"Quickstart Page","operationId":"quickstart_page_quickstart_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/docs":{"get":{"summary":"Docs Redirect","operationId":"docs_redirect_docs_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/catalog":{"get":{"summary":"Catalog Index","operationId":"catalog_index_catalog_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/catalog/{cat_slug}":{"get":{"summary":"Catalog Category","operationId":"catalog_category_catalog__cat_slug__get","parameters":[{"name":"cat_slug","in":"path","required":true,"schema":{"type":"string","title":"Cat Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/catalog/{cat_slug}/{region_slug}":{"get":{"summary":"Catalog Category Region","operationId":"catalog_category_region_catalog__cat_slug___region_slug__get","parameters":[{"name":"cat_slug","in":"path","required":true,"schema":{"type":"string","title":"Cat Slug"}},{"name":"region_slug","in":"path","required":true,"schema":{"type":"string","title":"Region Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"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"}}},"tags":[{"name":"Search (Free)","description":"Search companies and projects - no API key required"},{"name":"Companies (Free)","description":"Company details and listings - no API key required"},{"name":"Market Data (Free)","description":"Categories, regions, statistics - no API key required"},{"name":"Analytics (Starter+)","description":"Market analytics - requires Starter plan (2990 RUB/mo)"},{"name":"AI Tools (Pro+)","description":"AI-powered analysis - requires Pro plan (7990 RUB/mo)"},{"name":"Account","description":"API key registration and management"}]}