{"openapi":"3.0.3","info":{"title":"НейроЭксперт Knowledge API","version":"1.0.0","description":"API для доступа к данным экспертов и экспертного контента платформы НейроЭксперт. Используйте API-ключ для аутентификации.","contact":{"email":"api@neuroexpertise.ru"}},"servers":[{"url":"https://neuroexpertise.ru/api/v1","description":"Production"}],"security":[{"BearerAuth":[]},{"ApiKeyQuery":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"API key as Bearer token: Authorization: Bearer ne_..."},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"api_key","description":"API key as query parameter: ?api_key=ne_..."}},"schemas":{"Expert":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"full_name":{"type":"string","example":"Иван Иванов"},"slug":{"type":"string","example":"ivan-ivanov-a1b2c3d4"},"profile_url":{"type":"string","example":"https://neuroexpertise.ru/experts/ivan-ivanov"},"qualification":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"bio":{"type":"string","nullable":true},"trust_score":{"type":"number","example":42.5},"avg_rating":{"type":"number","example":4.8},"review_count":{"type":"integer","example":12},"years_experience":{"type":"integer","nullable":true},"is_verified":{"type":"boolean"},"knows_about":{"type":"array","items":{"type":"string"},"nullable":true},"consultation_price":{"type":"integer","nullable":true},"article_count":{"type":"integer"},"niche":{"type":"object","nullable":true,"properties":{"name":{"type":"string"},"slug":{"type":"string"},"icon":{"type":"string"}}}}},"Article":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"title":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string"},"meta_title":{"type":"string","nullable":true},"meta_description":{"type":"string","nullable":true},"keywords":{"type":"string","nullable":true},"word_count":{"type":"integer"},"published_at":{"type":"string","format":"date-time"},"faq":{"type":"array","nullable":true},"expert":{"type":"object","nullable":true,"properties":{"full_name":{"type":"string"},"slug":{"type":"string"},"qualification":{"type":"string","nullable":true}}}}},"Pagination":{"type":"object","properties":{"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"}}},"Error":{"type":"object","properties":{"error":{"type":"string"},"docs":{"type":"string"}}}}},"paths":{"/experts":{"get":{"summary":"Список экспертов","description":"Возвращает список опубликованных экспертов с пагинацией.","parameters":[{"name":"q","in":"query","description":"Поиск по имени или квалификации","schema":{"type":"string"}},{"name":"niche","in":"query","description":"Фильтр по slug ниши","schema":{"type":"string"}},{"name":"city","in":"query","description":"Фильтр по городу (частичное совпадение)","schema":{"type":"string"}},{"name":"limit","in":"query","description":"Количество результатов (макс. 100)","schema":{"type":"integer","default":20}},{"name":"offset","in":"query","description":"Смещение для пагинации","schema":{"type":"integer","default":0}}],"responses":{"200":{"description":"Список экспертов","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Expert"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}}}}},"401":{"description":"API key missing or invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded"}}}},"/articles":{"get":{"summary":"Список статей","description":"Возвращает список опубликованных экспертных статей с пагинацией.","parameters":[{"name":"q","in":"query","description":"Поиск по заголовку или описанию","schema":{"type":"string"}},{"name":"expert","in":"query","description":"Фильтр по slug эксперта","schema":{"type":"string"}},{"name":"limit","in":"query","description":"Количество (макс. 100)","schema":{"type":"integer","default":20}},{"name":"offset","in":"query","description":"Смещение","schema":{"type":"integer","default":0}}],"responses":{"200":{"description":"Список статей","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Article"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}}}}},"401":{"description":"API key missing or invalid"}}}},"/questions":{"get":{"summary":"Список вопросов","description":"Вопросы с массовым спросом, gap-анализ AI-ответов, количество экспертных ответов.","parameters":[{"name":"q","in":"query","description":"Поиск по тексту вопроса","schema":{"type":"string"}},{"name":"niche","in":"query","description":"Фильтр по slug ниши","schema":{"type":"string"}},{"name":"min_gap_score","in":"query","description":"Минимальный gap score (0-10)","schema":{"type":"integer"}},{"name":"has_answers","in":"query","description":"Только с/без экспертных ответов","schema":{"type":"string","enum":["true","false"]}},{"name":"limit","in":"query","schema":{"type":"integer","default":20}},{"name":"offset","in":"query","schema":{"type":"integer","default":0}}],"responses":{"200":{"description":"Список вопросов с gap-маркерами"},"401":{"description":"API key required"}}}},"/answers":{"get":{"summary":"Verified Expert Answers (Premium)","description":"Полный контент экспертных ответов с аудио, цитатами и лицензией. Требует permission 'answers'.","parameters":[{"name":"question_id","in":"query","description":"UUID вопроса","schema":{"type":"string"}},{"name":"niche","in":"query","description":"Фильтр по slug ниши","schema":{"type":"string"}},{"name":"q","in":"query","description":"Поиск по заголовку","schema":{"type":"string"}},{"name":"verified","in":"query","description":"Только верифицированные эксперты (default: true)","schema":{"type":"string","enum":["true","false"]}},{"name":"limit","in":"query","schema":{"type":"integer","default":10}},{"name":"offset","in":"query","schema":{"type":"integer","default":0}}],"responses":{"200":{"description":"Verified answers with full article, FAQ, audio URL, expert credentials, and license info"},"401":{"description":"API key required"},"403":{"description":"Permission 'answers' required (Premium plan)"}}}},"/blind-spots":{"get":{"summary":"Карта слепых зон AI (Premium)","description":"Data-продукт для SEO-агентств. Вопросы с массовым спросом и слабыми AI-ответами, сгруппированные по нишам. Opportunity score для приоритизации.","parameters":[{"name":"niche","in":"query","description":"Фильтр по slug ниши","schema":{"type":"string"}},{"name":"min_gap_score","in":"query","description":"Минимальный gap score (default: 6)","schema":{"type":"integer","default":6}},{"name":"min_volume","in":"query","description":"Минимальный месячный объём (default: 1000)","schema":{"type":"integer","default":1000}},{"name":"limit","in":"query","schema":{"type":"integer","default":50}},{"name":"offset","in":"query","schema":{"type":"integer","default":0}}],"responses":{"200":{"description":"Blind spots with gap markers, sub-queries, opportunity scores, and niche summary"},"403":{"description":"Requires 'answers' permission (Pro plan)"}}}}},"x-api-plans":{"read":{"name":"Read","price":"Free","endpoints":["/experts","/articles","/questions"],"rate_limit":"100 req/hour","permissions":["read"]},"answers":{"name":"Pro","price":"$99/mo","endpoints":["/experts","/articles","/questions","/answers","/blind-spots"],"rate_limit":"1000 req/hour","permissions":["read","answers"],"features":["Full article content","Audio URLs","Expert quotes","License for commercial use"]},"enterprise":{"name":"Enterprise","price":"Custom","endpoints":["All"],"rate_limit":"Custom","permissions":["all"],"features":["Dedicated support","SLA 99.9%","Custom integrations","Bulk export"]}}}