Reddit User Profile
Un perfil de usuario de Reddit es la página pública de la cuenta que hay detrás de un nombre u/, con el karma total repartido entre publicaciones y comentarios, la cantidad de publicaciones y comentarios que ha hecho, su fecha de creación, descripción, avatar, trofeos e insignias de cuentas verificadas y de empleados de Reddit. En conjunto, estas señales indican qué tan consolidada y activa está una cuenta, algo útil para evaluar a creadores de contenido, filtrar cuentas nuevas o con poco karma y seguir con el tiempo a los miembros influyentes de un nicho.
Funcionalidades de la Reddit User Profile API
- Hasta 100 nombres de usuario por solicitudusernames admite hasta 100 nombres de Reddit, con o sin el prefijo u/, y cada cuenta existente vuelve como una fila propia.
- Karma separado por origenmetrics.karma_count da el karma total, y post_karma_count y comment_karma_count muestran si se ganó publicando o comentando.
- Actividad y antigüedad de la cuentaposts_count y comments_count miden cuánto ha aportado la cuenta, y published_at registra el momento en que se creó.
- Insignias del perfil y trofeosis_verified, is_employee e is_nsfw recogen los indicadores que Reddit asigna a la cuenta y trophies_count indica el tamaño de su vitrina de trofeos, junto al nombre visible, la descripción, el avatar y el banner.
Parámetros de la Reddit User Profile API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
usernames | Obligatorio | Hasta 100 nombres de usuario de Reddit, con o sin el prefijo u/; cada nombre tiene de 3 a 20 letras, dígitos, guiones o guiones bajos. |
Cómo usar la Reddit User Profile API
Envíe una lista de nombres de usuario de Reddit y lea una fila de perfil por cada cuenta existente.
- Envíe {"usernames": ["spez", "GovSchwarzenegger"]} por POST a /v1/reddit/user-profile.
- Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
- Lea los perfiles en results.items y siga pidiendo páginas con results.next_cursor mientras has_more sea 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"]}'Casos de uso de la Reddit User Profile API
- Evaluar a un creador antes de contactarlo: Revise karma_count, posts_count y published_at para confirmar que la persona de Reddit a la que piensa escribir tiene un historial largo y activo.
- Filtrar cuentas nuevas o con poco karma: Marque los nombres con un published_at reciente y un karma_count bajo al revisar a los autores de una oleada de publicaciones o comentarios parecidos.
- Seguir una lista de cuentas de un nicho: Vuelva a consultar los mismos nombres de forma periódica y compare karma_count, posts_count y followers_count para ver qué miembros están creciendo.
- Completar una lista de usuarios de Reddit: Agregue el nombre visible, la descripción, avatar_url y la url del perfil a los nombres reunidos en hilos, para que una hoja de cálculo o un CRM muestre quién es cada persona.
Consejos de expertos para la Reddit User Profile API
- Limpie los nombres antes de enviarlos: sin el prefijo u/, cada uno debe tener de 3 a 20 letras, dígitos, guiones o guiones bajos, y una sola entrada mal formada rechaza toda la solicitud.
- Relacione las filas con su entrada usando el nombre en minúsculas, porque un nombre enviado dos veces con distintas mayúsculas se consulta una sola vez y devuelve una única fila.
- Divida las listas de más de 100 nombres en lotes de 100 y combine los resultados por id, el identificador permanente de la cuenta en Reddit.
APIs relacionadas
Además de la Reddit User Profile API, use estas APIs cuando necesite otro tipo de datos públicos de Reddit.
- Reddit Posts API — Recolecta desde URLs de Reddit compatibles el texto de publicaciones públicas, autores, contexto de la comunidad, contenido multimedia, marcas de tiempo e interacción visible.
- Reddit Subreddit Details API
- Reddit User Posts API — Recolecta el historial de publicaciones de un usuario de Reddit a partir de su nombre, en orden new, top o hot, con título y cuerpo, puntaje, comentarios y contenido multimedia.
- Reddit User Comments API — Recolecta el historial de comentarios de un usuario de Reddit a partir de su nombre, con extractos de 300 caracteres, puntajes, enlaces a cada comentario e IDs de publicación.
- Reddit User Active Subreddits API — Lista los subreddits en los que está activo un usuario de Reddit a partir de su nombre, con la cantidad de miembros y la descripción de cada uno.
- Reddit Subreddit Rules API — Obtiene las reglas numeradas de subreddits a partir de sus URL, con el título corto y el texto completo de cada regla.