Reddit
Доступ к данным и контенту Reddit
Reddit — это социальная платформа, где пользователи делятся контентом и обсуждают его в тематических сообществах, называемых сабреддитами.
Интеграция Reddit в AACFlow позволяет:
- Получение постов: получайте посты из любого сабреддита с возможностью сортировки (Hot, New, Top, Rising) и фильтрации Top-постов по времени (день, неделя, месяц, год, всё время).
- Получение комментариев: получайте комментарии к конкретному посту с возможностью сортировки и указания количества комментариев.
Эти операции позволяют вашим AI-агентам получать и анализировать контент Reddit в рамках автоматизированных воркфлоу.
Интегрируйте Reddit into workflows. Read posts, comments, и search content. Submit posts, vote, reply, edit, manage messages, и access user и subreddit info.
Получить посты from a subreddit с different сортировка options
| Параметр | Тип | Обязательный | Описание |
|---|
subreddit | string | Да | The subreddit to Получить посты from (e.g., "technology", "news") |
sort | string | Нет | Sort method for posts (e.g., "hot", "new", "top", "rising", "controversial"). Default: "hot" |
limit | number | Нет | Maximum number of posts to return (e.g., 25). Default: 10, max: 100 |
time | string | Нет | Time filter for "top" sorted posts: "day", "week", "month", "year", or "all" (default: "all") |
after | string | Нет | Fullname of a thing to fetch items after (for постраничная выборка) |
before | string | Нет | Fullname of a thing to fetch items before (for постраничная выборка) |
count | number | Нет | A count of items already seen in the listing (used for numbering) |
show | string | Нет | Show items that would normally be filtered (e.g., "all") |
sr_detail | boolean | Нет | Expand subreddit details in the response |
g | string | Нет | Geo filter for posts (e.g., "GLOBAL", "US", "AR", etc.) |
| Параметр | Тип | Описание |
|---|
subreddit | string | Name of the subreddit where posts were fetched from |
posts | array | Массив posts with title, author, URL, score, comments count, and metadata |
↳ id | string | Post ID |
↳ name | string | Thing fullname (t3_xxxxx) |
↳ title | string | Post title |
↳ author | string | Author username |
↳ url | string | Post URL |
↳ permalink | string | Reddit permalink |
↳ score | number | Post score (upvotes - downvotes) |
↳ num_comments | number | Number of comments |
↳ created_utc | number | Creation timestamp (UTC) |
↳ is_self | boolean | Произошла ли эта is a text post |
↳ selftext | string | Text content for self posts |
↳ thumbnail | string | Thumbnail URL |
↳ subreddit | string | Subreddit name |
after | string | Fullname of the last item for forward постраничная выборка |
before | string | Fullname of the first item for backward постраничная выборка |
Fetch comments from a specific Reddit post
| Параметр | Тип | Обязательный | Описание |
|---|
postId | string | Да | The ID of the Reddit post to fetch comments from (e.g., "abc123") |
subreddit | string | Да | The subreddit where the post is located (e.g., "technology", "programming") |
sort | string | Нет | Sort method for comments: "confidence", "top", "new", "controversial", "old", "random", "qa" (default: "confidence") |
limit | number | Нет | Maximum number of comments to return (e.g., 25). Default: 50, max: 100 |
depth | number | Нет | Maximum depth of subtrees in the thread (controls nested comment levels) |
context | number | Нет | Number of parent comments to include |
showedits | boolean | Нет | Show edit information for comments |
showmore | boolean | Нет | Include "load more comments" elements in the response |
threaded | boolean | Нет | Return comments in threaded/nested format |
truncate | number | Нет | Integer to truncate comment depth |
comment | string | Нет | ID36 of a comment to focus on (returns that comment thread) |
| Параметр | Тип | Описание |
|---|
post | object | Post information including ID, title, author, content, and metadata |
↳ id | string | Post ID |
↳ name | string | Thing fullname (t3_xxxxx) |
↳ title | string | Post title |
↳ author | string | Post author |
↳ selftext | string | Post text content |
↳ score | number | Post score |
↳ created_utc | number | Creation timestamp |
↳ permalink | string | Reddit permalink |
comments | array | Nested comments with author, body, score, timestamps, and replies |
↳ id | string | Comment ID |
↳ name | string | Thing fullname (t1_xxxxx) |
↳ author | string | Comment author |
↳ body | string | Comment text |
↳ score | number | Comment score |
↳ created_utc | number | Creation timestamp |
↳ permalink | string | Comment permalink |
↳ replies | array | Nested reply comments |
Fetch controversial posts from a subreddit
| Параметр | Тип | Обязательный | Описание |
|---|
subreddit | string | Да | The subreddit to Получить посты from (e.g., "technology", "news") |
time | string | Нет | Time filter for controversial posts: "hour", "day", "week", "month", "year", or "all" (default: "all") |
limit | number | Нет | Maximum number of posts to return (e.g., 25). Default: 10, max: 100 |
after | string | Нет | Fullname of a thing to fetch items after (for постраничная выборка) |
before | string | Нет | Fullname of a thing to fetch items before (for постраничная выборка) |
count | number | Нет | A count of items already seen in the listing (used for numbering) |
show | string | Нет | Show items that would normally be filtered (e.g., "all") |
sr_detail | boolean | Нет | Expand subreddit details in the response |
| Параметр | Тип | Описание |
|---|
subreddit | string | Name of the subreddit where posts were fetched from |
posts | array | Массив controversial posts with title, author, URL, score, comments count, and metadata |
↳ id | string | Post ID |
↳ name | string | Thing fullname (t3_xxxxx) |
↳ title | string | Post title |
↳ author | string | Author username |
↳ url | string | Post URL |
↳ permalink | string | Reddit permalink |
↳ score | number | Post score (upvotes - downvotes) |
↳ num_comments | number | Number of comments |
↳ created_utc | number | Creation timestamp (UTC) |
↳ is_self | boolean | Произошла ли эта is a text post |
↳ selftext | string | Text content for self posts |
↳ thumbnail | string | Thumbnail URL |
↳ subreddit | string | Subreddit name |
after | string | Fullname of the last item for forward постраничная выборка |
before | string | Fullname of the first item for backward постраничная выборка |
Поиск posts within a subreddit
| Параметр | Тип | Обязательный | Описание |
|---|
subreddit | string | Да | The subreddit to search in (e.g., "technology", "programming") |
query | string | Да | Search query text (e.g., "artificial intelligence", "machine learning tutorial") |
sort | string | Нет | Sort method for search results (e.g., "relevance", "hot", "top", "new", "comments"). Default: "relevance" |
time | string | Нет | Time filter for search results: "hour", "day", "week", "month", "year", or "all" (default: "all") |
limit | number | Нет | Maximum number of posts to return (e.g., 25). Default: 10, max: 100 |
restrict_sr | boolean | Нет | Restrict search to the specified subreddit only (default: true) |
after | string | Нет | Fullname of a thing to fetch items after (for постраничная выборка) |
before | string | Нет | Fullname of a thing to fetch items before (for постраничная выборка) |
count | number | Нет | A count of items already seen in the listing (used for numbering) |
show | string | Нет | Show items that would normally be filtered (e.g., "all") |
type | string | Нет | Type of search results: "link" (posts), "sr" (subreddits), or "user" (users). Default: "link" |
sr_detail | boolean | Нет | Expand subreddit details in the response |
| Параметр | Тип | Описание |
|---|
subreddit | string | Name of the subreddit where search was performed |
posts | array | Массив search result posts with title, author, URL, score, comments count, and metadata |
↳ id | string | Post ID |
↳ name | string | Thing fullname (t3_xxxxx) |
↳ title | string | Post title |
↳ author | string | Author username |
↳ url | string | Post URL |
↳ permalink | string | Reddit permalink |
↳ score | number | Post score (upvotes - downvotes) |
↳ num_comments | number | Number of comments |
↳ created_utc | number | Creation timestamp (UTC) |
↳ is_self | boolean | Произошла ли эта is a text post |
↳ selftext | string | Text content for self posts |
↳ thumbnail | string | Thumbnail URL |
↳ subreddit | string | Subreddit name |
after | string | Fullname of the last item for forward постраничная выборка |
before | string | Fullname of the first item for backward постраничная выборка |
Submit a new post to a subreddit (text или link)
| Параметр | Тип | Обязательный | Описание |
|---|
subreddit | string | Да | The subreddit to post to (e.g., "technology", "programming") |
title | string | Да | Title of the submission (e.g., "Check out this new AI tool"). Max 300 characters |
text | string | Нет | Text content for a self post in markdown format (e.g., "This is the body of my post") |
url | string | Нет | URL for a link post (cannot be used with text) |
nsfw | boolean | Нет | Mark post as NSFW |
spoiler | boolean | Нет | Mark post as spoiler |
send_replies | boolean | Нет | Send reply notifications to inbox (default: true) |
flair_id | string | Нет | Flair template UUID for the post (max 36 characters) |
flair_text | string | Нет | Flair text to display on the post (max 64 characters) |
collection_id | string | Нет | Collection UUID to add the post to |
| Параметр | Тип | Описание |
|---|
success | boolean | Произошла ли post was submitted successfully |
message | string | Success or error message |
data | object | Post data including ID, name, URL, and permalink |
↳ id | string | New post ID |
↳ name | string | Thing fullname (t3_xxxxx) |
↳ url | string | Post URL from API response |
↳ permalink | string | Full Reddit permalink |
Upvote, downvote, или unvote a Reddit post или comment
| Параметр | Тип | Обязательный | Описание |
|---|
id | string | Да | Thing fullname to vote on (e.g., "t3_abc123" for post, "t1_def456" for comment) |
dir | number | Да | Vote direction: 1 (upvote), 0 (unvote), or -1 (downvote) |
| Параметр | Тип | Описание |
|---|
success | boolean | Произошла ли vote was successful |
message | string | Success or error message |
Save a Reddit post или comment to your saved items
| Параметр | Тип | Обязательный | Описание |
|---|
id | string | Да | Thing fullname to save (e.g., "t3_abc123" for post, "t1_def456" for comment) |
category | string | Нет | Category to save under (Reddit Gold feature) |
| Параметр | Тип | Описание |
|---|
success | boolean | Произошла ли save was successful |
message | string | Success or error message |
| Параметр | Тип | Обязательный | Описание |
|---|
| Параметр | Тип | Описание |
|---|
subreddit | string | Subreddit name |
posts | json | Posts data |
post | json | Single post data |
comments | json | Comments data |
success | boolean | Operation success status |
message | string | Result message |
data | json | Response data |
after | string | Pagination cursor (next page) |
before | string | Pagination cursor (previous page) |
id | string | Entity ID |
name | string | Entity fullname |
messages | json | Messages data |
display_name | string | Subreddit display name |
subscribers | number | Subscriber count |
description | string | Description text |
link_karma | number | Link karma |
comment_karma | number | Comment karma |
total_karma | number | Total karma |
icon_img | string | Icon image URL |
Добавить комментарий reply to a Reddit post или comment
| Параметр | Тип | Обязательный | Описание |
|---|
parent_id | string | Да | Thing fullname to reply to (e.g., "t3_abc123" for post, "t1_def456" for comment) |
text | string | Да | Comment text in markdown format (e.g., "Great post! Here is my reply") |
return_rtjson | boolean | Нет | Return response in Rich Text JSON format |
| Параметр | Тип | Описание |
|---|
success | boolean | Произошла ли reply was posted successfully |
message | string | Success or error message |
data | object | Comment data including ID, name, permalink, and body |
↳ id | string | New comment ID |
↳ name | string | Thing fullname (t1_xxxxx) |
↳ permalink | string | Comment permalink |
↳ body | string | Comment body text |
Edit the text of your own Reddit post или comment
| Параметр | Тип | Обязательный | Описание |
|---|
thing_id | string | Да | Thing fullname to edit (e.g., "t3_abc123" for post, "t1_def456" for comment) |
text | string | Да | New text content in markdown format (e.g., "Updated content here") |
| Параметр | Тип | Описание |
|---|
success | boolean | Произошла ли edit was successful |
message | string | Success or error message |
data | object | Updated content data |
↳ id | string | Edited thing ID |
↳ body | string | Updated comment body (for comments) |
↳ selftext | string | Updated post text (for self posts) |
Удалить your own Reddit post или comment
| Параметр | Тип | Обязательный | Описание |
|---|
id | string | Да | Thing fullname to delete (e.g., "t3_abc123" for post, "t1_def456" for comment) |
| Параметр | Тип | Описание |
|---|
success | boolean | Произошла ли deletion was successful |
message | string | Success or error message |
Subscribe или unsubscribe from a subreddit
| Параметр | Тип | Обязательный | Описание |
|---|
subreddit | string | Да | The subreddit to subscribe to or unsubscribe from (e.g., "technology", "programming") |
action | string | Да | Action to perform: "sub" to subscribe or "unsub" to unsubscribe |
| Параметр | Тип | Описание |
|---|
success | boolean | Произошла ли subscription action was successful |
message | string | Success or error message |
Получить информацию о the authenticated Reddit user
| Параметр | Тип | Обязательный | Описание |
|---|
| Параметр | Тип | Описание |
|---|
id | string | User ID |
name | string | Username |
created_utc | number | Account creation time in UTC epoch seconds |
link_karma | number | Total link karma |
comment_karma | number | Total comment karma |
total_karma | number | Combined total karma |
is_gold | boolean | Whether user has Reddit Premium |
is_mod | boolean | Whether user is a moderator |
has_verified_email | boolean | Whether email is verified |
icon_img | string | User avatar/icon URL |
Получить public profile information about any Reddit user by username
| Параметр | Тип | Обязательный | Описание |
|---|
username | string | Да | Reddit username to look up (e.g., "spez", "example_user") |
| Параметр | Тип | Описание |
|---|
id | string | User ID |
name | string | Username |
created_utc | number | Account creation time in UTC epoch seconds |
link_karma | number | Total link karma |
comment_karma | number | Total comment karma |
total_karma | number | Combined total karma |
is_gold | boolean | Whether user has Reddit Premium |
is_mod | boolean | Whether user is a moderator |
has_verified_email | boolean | Whether email is verified |
icon_img | string | User avatar/icon URL |
Отправить a private message to a Reddit user
| Параметр | Тип | Обязательный | Описание |
|---|
to | string | Да | Recipient username (e.g., "example_user") or subreddit (e.g., "/r/subreddit") |
subject | string | Да | Message subject (max 100 characters) |
text | string | Да | Message body in markdown format |
from_sr | string | Нет | Subreddit name to send the message from (requires moderator mail permission) |
| Параметр | Тип | Описание |
|---|
success | boolean | Произошла ли message was sent successfully |
message | string | Success or error message |
Получить private messages from your Reddit inbox
| Параметр | Тип | Обязательный | Описание |
|---|
where | string | Нет | Message folder to retrieve: "inbox" (all), "unread", "sent", "messages" (direct messages only), "comments" (comment replies), "selfreply" (self-post replies), or "mentions" (username mentions). Default: "inbox" |
limit | number | Нет | Maximum number of messages to return (e.g., 25). Default: 25, max: 100 |
after | string | Нет | Fullname of a thing to fetch items after (for постраничная выборка) |
before | string | Нет | Fullname of a thing to fetch items before (for постраничная выборка) |
mark | boolean | Нет | Whether to mark fetched messages as read |
count | number | Нет | A count of items already seen in the listing (used for numbering) |
show | string | Нет | Show items that would normally be filtered (e.g., "all") |
| Параметр | Тип | Описание |
|---|
messages | array | Массив messages with sender, recipient, subject, body, and metadata |
↳ id | string | Message ID |
↳ name | string | Thing fullname (t4_xxxxx) |
↳ author | string | Sender username |
↳ dest | string | Recipient username |
↳ subject | string | Message subject |
↳ body | string | Message body text |
↳ created_utc | number | Creation time in UTC epoch seconds |
↳ new | boolean | Произошла ли message is unread |
↳ was_comment | boolean | Произошла ли message is a comment reply |
↳ context | string | Context URL for comment replies |
↳ distinguished | string | Distinction: null/"moderator"/"admin" |
after | string | Fullname of the last item for forward постраничная выборка |
before | string | Fullname of the first item for backward постраничная выборка |
Получить metadata и information about a subreddit
| Параметр | Тип | Обязательный | Описание |
|---|
subreddit | string | Да | The subreddit to get info about (e.g., "technology", "programming", "news") |
| Параметр | Тип | Описание |
|---|
id | string | Subreddit ID |
name | string | Subreddit fullname (t5_xxxxx) |
display_name | string | Subreddit name without prefix |
title | string | Subreddit title |
description | string | Full subreddit description (markdown) |
public_description | string | Short public description |
subscribers | number | Number of subscribers |
accounts_active | number | Number of currently active users |
created_utc | number | Creation time in UTC epoch seconds |
over18 | boolean | Произошла ли subreddit is NSFW |
lang | string | Primary language of the subreddit |
subreddit_type | string | Subreddit type: public, private, restricted, etc. |
url | string | Subreddit URL path (e.g., /r/technology/) |
icon_img | string | Subreddit icon URL |
banner_img | string | Subreddit banner URL |
