{"openapi":"3.1.0","info":{"title":"tg.place API","version":"1.0.0","description":"Чтение каталога Telegram-каналов, ботов и mini apps, плюс состояние монитора доступности. Ключ передаётся заголовком x-api-key и создаётся в кабинете. Бесплатный тариф — 1000 запросов в сутки на ключ, счётчик обнуляется в 00:00 UTC."},"servers":[{"url":"https://tg.place/api/v1"}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","in":"header","name":"x-api-key"}}},"security":[{"apiKey":[]}],"paths":{"/search":{"get":{"summary":"Поиск по каталогу","parameters":[{"name":"q","in":"query","required":true,"description":"Строка поиска","schema":{"type":"string","minLength":1,"maxLength":120}},{"name":"locale","in":"query","required":false,"description":"Язык выдачи, ru или en","schema":{"type":"string","enum":["ru","en"]}},{"name":"kind","in":"query","required":false,"description":"Тип записи","schema":{"type":"string","enum":["channel","bot","miniapp"]}},{"name":"category","in":"query","required":false,"description":"Слаг категории","schema":{"type":"string","maxLength":64}},{"name":"page","in":"query","required":false,"description":"Страница","schema":{"type":"integer","minimum":1,"maximum":50}},{"name":"limit","in":"query","required":false,"description":"Записей на страницу, до 50","schema":{"type":"integer","minimum":1,"maximum":50}}],"responses":{"200":{"description":"Найденные записи"},"401":{"description":"Ключ не передан, не найден или отозван","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs":{"type":"string"}},"required":["code","message"]}}}}}},"429":{"description":"Потолок суток исчерпан. Заголовок Retry-After — секунды до 00:00 UTC","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs":{"type":"string"}},"required":["code","message"]}}}}}}}}},"/listings/{slug}":{"get":{"summary":"Одна запись каталога","parameters":[{"name":"slug","in":"path","required":true,"description":"Слаг записи со страницы каталога","schema":{"type":"string"}},{"name":"locale","in":"query","required":false,"description":"Язык выдачи, ru или en","schema":{"type":"string","enum":["ru","en"]}}],"responses":{"200":{"description":"Запись с метриками и оценкой"},"401":{"description":"Ключ не передан, не найден или отозван","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs":{"type":"string"}},"required":["code","message"]}}}}}},"404":{"description":"Записи нет или она снята с публикации","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs":{"type":"string"}},"required":["code","message"]}}}}}},"429":{"description":"Потолок суток исчерпан. Заголовок Retry-After — секунды до 00:00 UTC","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs":{"type":"string"}},"required":["code","message"]}}}}}}}}},"/categories":{"get":{"summary":"Дерево категорий по типам записей","parameters":[{"name":"locale","in":"query","required":false,"description":"Язык выдачи, ru или en","schema":{"type":"string","enum":["ru","en"]}}],"responses":{"200":{"description":"Категории"},"401":{"description":"Ключ не передан, не найден или отозван","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs":{"type":"string"}},"required":["code","message"]}}}}}},"429":{"description":"Потолок суток исчерпан. Заголовок Retry-After — секунды до 00:00 UTC","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs":{"type":"string"}},"required":["code","message"]}}}}}}}}},"/top":{"get":{"summary":"Топ каталога по Place Score","parameters":[{"name":"locale","in":"query","required":false,"description":"Язык выдачи, ru или en","schema":{"type":"string","enum":["ru","en"]}},{"name":"kind","in":"query","required":false,"description":"Тип записи","schema":{"type":"string","enum":["channel","bot","miniapp"]}},{"name":"limit","in":"query","required":false,"description":"Сколько записей вернуть, до 100","schema":{"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"Записи топа"},"401":{"description":"Ключ не передан, не найден или отозван","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs":{"type":"string"}},"required":["code","message"]}}}}}},"429":{"description":"Потолок суток исчерпан. Заголовок Retry-After — секунды до 00:00 UTC","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs":{"type":"string"}},"required":["code","message"]}}}}}}}}},"/status":{"get":{"summary":"Состояние «Сигнала» — монитора доступности Telegram","parameters":[],"responses":{"200":{"description":"Текущее состояние"},"401":{"description":"Ключ не передан, не найден или отозван","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs":{"type":"string"}},"required":["code","message"]}}}}}},"429":{"description":"Потолок суток исчерпан. Заголовок Retry-After — секунды до 00:00 UTC","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"docs":{"type":"string"}},"required":["code","message"]}}}}}}}}}}}