Reddit User Profile
Профиль пользователя Reddit — это публичная страница аккаунта за именем u/, где видны общая карма с разбивкой на публикации и комментарии, число публикаций и комментариев, дата создания, описание, аватар, трофеи и значки верифицированных аккаунтов и сотрудников Reddit. Вместе эти сигналы показывают, насколько аккаунт опытный и активный, а это помогает проверять авторов, отсеивать новые аккаунты или аккаунты с низкой кармой и наблюдать за влиятельными участниками ниши.
Возможности Reddit User Profile API
- До 100 имен в одном запросеusernames принимает до 100 имен Reddit с префиксом u/ или без него, и каждый существующий аккаунт возвращается отдельной строкой.
- Карма по источникамmetrics.karma_count дает общую карму, а post_karma_count и comment_karma_count показывают, заработана она публикациями или комментариями.
- Счетчики активности и возраст аккаунтаposts_count и comments_count показывают объем вклада аккаунта, а published_at фиксирует момент его создания.
- Значки и трофеи профиляis_verified, is_employee и is_nsfw передают собственные отметки Reddit, а trophies_count показывает число трофеев — рядом с отображаемым именем, описанием, аватаром и баннером.
Параметры Reddit User Profile API
| Параметры | Обязательный | Описание |
|---|---|---|
usernames | Обязательный | До 100 имен пользователей Reddit с префиксом u/ или без него; каждое имя состоит из 3–20 букв, цифр, дефисов или подчеркиваний. |
Как использовать Reddit User Profile API
Отправьте список имен пользователей Reddit и получите по одной строке профиля на каждый существующий аккаунт.
- Отправьте {"usernames": ["spez", "GovSchwarzenegger"]} методом POST на /v1/reddit/user-profile.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте профили из results.items и продолжайте запросы с results.next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/reddit/user-profile" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["spez","GovSchwarzenegger"]}'Сценарии использования Reddit User Profile API
- Проверка автора перед сотрудничеством: Сверяйте karma_count, posts_count и published_at, чтобы убедиться, что у реддитора, с которым вы планируете связаться, долгая и активная история.
- Отсев новых аккаунтов и аккаунтов с низкой кармой: Отмечайте имена с недавним published_at и низким karma_count, когда разбираете авторов волны похожих публикаций или комментариев.
- Наблюдение за списком нишевых аккаунтов: Регулярно запускайте те же имена и сравнивайте karma_count, posts_count и followers_count, чтобы видеть, какие участники растут.
- Обогащение списка ников Reddit: Добавляйте отображаемое имя, описание, avatar_url и url профиля к именам, собранным из обсуждений, чтобы в таблице или CRM было видно, кто есть кто.
Практические советы по Reddit User Profile API
- Очищайте имена перед отправкой: после префикса u/ каждое должно содержать 3–20 букв, цифр, дефисов или подчеркиваний, а одна некорректная запись отклоняет весь запрос.
- Сопоставляйте строки с входным списком по имени в нижнем регистре: имя, переданное дважды в разном регистре, проверяется один раз и возвращает одну строку.
- Делите списки длиннее 100 имен на пакеты по 100 и объединяйте результаты по id — постоянному идентификатору аккаунта Reddit.
Связанные API
Помимо Reddit User Profile API, используйте эти API, когда нужен другой тип публичных данных Reddit.
- Reddit Posts API — Собирайте по поддерживаемым URL Reddit текст публичных публикаций, авторов, контекст сообщества, медиа, метки времени и видимую вовлеченность.
- Reddit Subreddit Details API
- Reddit User Posts API — Собирайте историю публикаций пользователя Reddit по одному имени с сортировкой new, top или hot: заголовок и текст, рейтинг, комментарии и медиа.
- Reddit User Comments API — Собирайте историю комментариев пользователя Reddit по одному имени: отрывки из 300 символов, рейтинг, ссылки на комментарии и ID публикаций.
- Reddit User Active Subreddits API — Получайте по одному имени список сабреддитов, в которых активен пользователь Reddit, с числом участников и описаниями.
- Reddit Subreddit Rules API — Получайте пронумерованные правила сабреддитов по их URL: короткое название и полный текст каждого правила.