Поиск и обнаружение — itd.search, itd.hashtags

Глобальный поиск, хэштеги и тренды, а также рекомендации, кланы и баннер события. Часть методов физически принадлежит другим ресурсам (itd.users, itd.platform) — здесь они собраны по смыслу.

Глобальный поиск — itd.search

all(query: string): Promise<SearchResult>

Ищет пользователей и хэштеги одним запросом.

interface SearchResult {
  users: UserSummary[];                  // см. models.md#usersummary
  hashtags: Hashtag[];                   // см. models.md#hashtag
}

Хэштеги — itd.hashtags

search(query?: string, params?: { limit?: number }): Promise<Hashtag[]>

Ищет хэштеги. Без строки запроса возвращает общий список.

trending(params?: { limit?: number }): Promise<Hashtag[]>

Трендовые хэштеги.

posts(tag: string, params?: HashtagPostsParams): Promise<Page<Post>>
iteratePosts(tag: string, params?: HashtagPostsParams): Paginator<Post>

Посты по хэштегу. Курсорная пагинация. tag — без решётки; кодируется автоматически, кириллица и пробелы допустимы. См. Post.

interface HashtagPostsParams extends RequestOptions {
  limit?: number;
  cursor?: string;
  maxPages?: number;
}

Пользователи — itd.users

Полное описание — в Пользователи.

itd.users.search(query: string, params?: { limit?: number }): Promise<UserSummary[]>

Поиск пользователей по строке.

itd.users.whoToFollow(): Promise<UserSummary[]>

Рекомендации, на кого подписаться.

itd.users.topClans(): Promise<Clan[]>

Рейтинг кланов. См. Clan.

Портал — itd.platform

itd.platform.portal(): Promise<Portal>

Баннер текущего события — виджет «портал». См. Portal и Платформа.

interface Portal {
  active: boolean;
  title: string;
  url: string;
}