Reddit

Reddit — форумы по темам (сабреддиты): посты, комментарии, голосование.

С Reddit в Pailot вы можете:

Читать посты (hot, new, top, rising, controversial) и искать внутри сабреддита
Читать комментарии к посту
Публиковать пост, отвечать, править и удалять своё
Голосовать, сохранять, подписываться на сабреддит

Имя сабреддита — без префикса r/. Для записи нужен вход в аккаунт. Блок ставят на холст как отдельный шаг или прикрепляют к агенту.

Инструменты

`reddit_get_posts`

Посты сабреддита с сортировкой.

Вход

Параметр	Тип	Обязательный	Описание
`subreddit`	string	Да	Имя сабреддита без префикса r/
`sort`	string	Нет	Сортировка: hot, new, top или rising (по умолчанию hot)
`limit`	number	Нет	Максимум постов (по умолчанию 10, макс. 100)
`time`	string	Нет	Период для top: day, week, month, year или all (по умолчанию day)
`after`	string	Нет	Fullname сущности — взять записи после неё (страница)
`before`	string	Нет	Fullname сущности — взять записи до неё (страница)
`count`	number	Нет	Сколько записей уже просмотрено (нумерация)
`show`	string	Нет	Показать обычно скрытые (например all)
`sr_detail`	boolean	Нет	Развернуть данные сабреддита в ответе

Выход

Параметр	Тип	Описание
`subreddit`	string	Имя сабреддита
`posts`	array	Посты: заголовок, автор, URL, рейтинг, число комментариев
↳ `id`	string	ID поста
↳ `title`	string	Заголовок
↳ `author`	string	Ник автора
↳ `url`	string	URL поста
↳ `permalink`	string	Постоянная ссылка Reddit
↳ `score`	number	Рейтинг (плюсы минус минусы)
↳ `num_comments`	number	Число комментариев
↳ `created_utc`	number	Время создания (UTC)
↳ `is_self`	boolean	Текстовый пост
↳ `selftext`	string	Текст self-поста
↳ `thumbnail`	string	URL миниатюры
↳ `subreddit`	string	Имя сабреддита

`reddit_get_comments`

Комментарии к посту.

Вход

Параметр	Тип	Обязательный	Описание
`postId`	string	Да	ID поста
`subreddit`	string	Да	Сабреддит поста без префикса r/
`sort`	string	Нет	Сортировка: confidence, top, new, controversial, old, random, qa (по умолчанию confidence)
`limit`	number	Нет	Максимум комментариев (по умолчанию 50, макс. 100)
`depth`	number	Нет	Глубина вложенных ответов
`context`	number	Нет	Сколько родительских комментариев включить
`showedits`	boolean	Нет	Показать сведения о правках
`showmore`	boolean	Нет	Включить элементы «ещё комментарии»
`showtitle`	boolean	Нет	Включить заголовок поста
`threaded`	boolean	Нет	Комментарии деревом
`truncate`	number	Нет	Обрезать глубину комментариев
`after`	string	Нет	Fullname сущности — взять записи после неё
`before`	string	Нет	Fullname сущности — взять записи до неё
`count`	number	Нет	Сколько записей уже просмотрено

Выход

Параметр	Тип	Описание
`post`	object	Пост: ID, заголовок, автор, текст
↳ `id`	string	ID поста
↳ `title`	string	Заголовок
↳ `author`	string	Автор
↳ `selftext`	string	Текст поста
↳ `score`	number	Рейтинг
↳ `created_utc`	number	Время создания
↳ `permalink`	string	Постоянная ссылка Reddit
`comments`	array	Комментарии: автор, текст, рейтинг, ответы
↳ `id`	string	ID комментария
↳ `author`	string	Автор
↳ `body`	string	Текст
↳ `score`	number	Рейтинг
↳ `created_utc`	number	Время создания
↳ `permalink`	string	Постоянная ссылка комментария
↳ `replies`	array	Вложенные ответы

`reddit_get_controversial`

Спорные посты сабреддита.

Вход

Параметр	Тип	Обязательный	Описание
`subreddit`	string	Да	Имя сабреддита без префикса r/
`time`	string	Нет	Период: hour, day, week, month, year или all (по умолчанию all)
`limit`	number	Нет	Максимум постов (по умолчанию 10, макс. 100)
`after`	string	Нет	Fullname сущности — взять записи после неё
`before`	string	Нет	Fullname сущности — взять записи до неё
`count`	number	Нет	Сколько записей уже просмотрено
`show`	string	Нет	Показать обычно скрытые (например all)
`sr_detail`	boolean	Нет	Развернуть данные сабреддита в ответе

Выход

Параметр	Тип	Описание
`subreddit`	string	Имя сабреддита
`posts`	array	Спорные посты: заголовок, автор, URL, рейтинг
↳ `id`	string	ID поста
↳ `title`	string	Заголовок
↳ `author`	string	Ник автора
↳ `url`	string	URL поста
↳ `permalink`	string	Постоянная ссылка Reddit
↳ `score`	number	Рейтинг (плюсы минус минусы)
↳ `num_comments`	number	Число комментариев
↳ `created_utc`	number	Время создания (UTC)
↳ `is_self`	boolean	Текстовый пост
↳ `selftext`	string	Текст self-поста
↳ `thumbnail`	string	URL миниатюры
↳ `subreddit`	string	Имя сабреддита

`reddit_search`

Поиск постов в сабреддите.

Вход

Параметр	Тип	Обязательный	Описание
`subreddit`	string	Да	Имя сабреддита без префикса r/
`query`	string	Да	Текст запроса
`sort`	string	Нет	Сортировка: relevance, hot, top, new или comments (по умолчанию relevance)
`time`	string	Нет	Период: hour, day, week, month, year или all (по умолчанию all)
`limit`	number	Нет	Максимум постов (по умолчанию 10, макс. 100)
`restrict_sr`	boolean	Нет	Искать только в указанном сабреддите (по умолчанию true)
`after`	string	Нет	Fullname сущности — взять записи после неё
`before`	string	Нет	Fullname сущности — взять записи до неё
`count`	number	Нет	Сколько записей уже просмотрено
`show`	string	Нет	Показать обычно скрытые (например all)

Выход

Параметр	Тип	Описание
`subreddit`	string	Сабреддит, в котором искали
`posts`	array	Найденные посты
↳ `id`	string	ID поста
↳ `title`	string	Заголовок
↳ `author`	string	Ник автора
↳ `url`	string	URL поста
↳ `permalink`	string	Постоянная ссылка Reddit
↳ `score`	number	Рейтинг (плюсы минус минусы)
↳ `num_comments`	number	Число комментариев
↳ `created_utc`	number	Время создания (UTC)
↳ `is_self`	boolean	Текстовый пост
↳ `selftext`	string	Текст self-поста
↳ `thumbnail`	string	URL миниатюры
↳ `subreddit`	string	Имя сабреддита

`reddit_submit_post`

Опубликовать пост (текст или ссылка).

Вход

Параметр	Тип	Обязательный	Описание
`subreddit`	string	Да	Имя сабреддита без префикса r/
`title`	string	Да	Заголовок (макс. 300 символов)
`text`	string	Нет	Текст self-поста (markdown)
`url`	string	Нет	URL ссылочного поста (нельзя вместе с text)
`nsfw`	boolean	Нет	Пометить как NSFW
`spoiler`	boolean	Нет	Пометить как спойлер
`send_replies`	boolean	Нет	Уведомления об ответах в inbox (по умолчанию true)

Выход

Параметр	Тип	Описание
`success`	boolean	Пост опубликован
`message`	string	Сообщение об успехе или ошибке
`data`	object	Данные поста: ID, name, URL, permalink

`reddit_vote`

Плюс, минус или снять голос с поста или комментария.

Вход

Параметр	Тип	Обязательный	Описание
`id`	string	Да	Fullname сущности (t3_xxxxx — пост, t1_xxxxx — комментарий)
`dir`	number	Да	Направление: 1 (плюс), 0 (снять), −1 (минус)

Выход

Параметр	Тип	Описание
`success`	boolean	Голос учтён
`message`	string	Сообщение об успехе или ошибке

`reddit_save`

Сохранить пост или комментарий.

Вход

Параметр	Тип	Обязательный	Описание
`id`	string	Да	Fullname сущности (t3_xxxxx — пост, t1_xxxxx — комментарий)
`category`	string	Нет	Категория сохранения (функция Reddit Gold)

Выход

Параметр	Тип	Описание
`success`	boolean	Сохранено
`message`	string	Сообщение об успехе или ошибке

`reddit_unsave`

Убрать пост или комментарий из сохранённых.

Вход

Параметр	Тип	Обязательный	Описание

Выход

Параметр	Тип	Описание
`subreddit`	string	Имя сабреддита
`posts`	json	Данные постов
`post`	json	Данные одного поста
`comments`	json	Данные комментариев

`reddit_reply`

Ответить комментарием на пост или комментарий.

Вход

Параметр	Тип	Обязательный	Описание
`parent_id`	string	Да	Fullname сущности (t3_xxxxx — пост, t1_xxxxx — комментарий)
`text`	string	Да	Текст комментария в markdown

Выход

Параметр	Тип	Описание
`success`	boolean	Ответ опубликован
`message`	string	Сообщение об успехе или ошибке
`data`	object	Данные комментария: ID, name, permalink, body

`reddit_edit`

Изменить текст своего поста или комментария.

Вход

Параметр	Тип	Обязательный	Описание
`thing_id`	string	Да	Fullname сущности (t3_xxxxx — пост, t1_xxxxx — комментарий)
`text`	string	Да	Новый текст в markdown

Выход

Параметр	Тип	Описание
`success`	boolean	Правка сохранена
`message`	string	Сообщение об успехе или ошибке
`data`	object	Обновлённые данные

`reddit_delete`

Удалить свой пост или комментарий.

Вход

Параметр	Тип	Обязательный	Описание
`id`	string	Да	Fullname сущности (t3_xxxxx — пост, t1_xxxxx — комментарий)

Выход

Параметр	Тип	Описание
`success`	boolean	Удаление успешно
`message`	string	Сообщение об успехе или ошибке

`reddit_subscribe`

Подписаться на сабреддит или отписаться.

Вход

Параметр	Тип	Обязательный	Описание
`subreddit`	string	Да	Имя сабреддита без префикса r/
`action`	string	Да	Действие: sub — подписаться, unsub — отписаться

Выход

Параметр	Тип	Описание
`success`	boolean	Действие выполнено
`message`	string	Сообщение об успехе или ошибке

Reddit

На этой странице