Facebook Group Posts
Las publicaciones de grupos de Facebook son novedades públicas de un grupo, con el texto del mensaje, la identidad del autor, la hora de publicación, los enlaces de origen, las reacciones, los comentarios y las vistas visibles, y los medios de video. Estos registros sirven para monitorear la actividad de los grupos, investigar debates, comparar la interacción y elaborar informes de contenido público.
Funcionalidades de la Facebook Group Posts API
- Lotes de URL de grupos públicosAcepta una o más URL de grupos públicos de Facebook y conserva la URL del grupo de origen en cada registro de publicación normalizado.
- Cuatro modos de orden de gruposUse top_posts, recent_activity, chronological o chronological_listings para seleccionar el orden que se aplica a todos los grupos enviados.
- Profundidad de recopilación por grupoAplica results_limit por separado a cada URL de grupo, con un valor predeterminado de 100 y un rango aceptado de 3 a 2,000.
- Contexto de la publicación y del autorDevuelve los ID de publicación, las URL de origen, el texto del mensaje, los ID y nombres de los autores, las horas de publicación y las horas de recopilación en una estructura uniforme.
- Interacción visible y videoIncluye los conteos visibles de reacciones, comentarios y vistas de video, además de las URL normalizadas del video y de la miniatura cuando una publicación pública las expone.
Parámetros de la Facebook Group Posts API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | URL obligatorias de grupos públicos de Facebook, separadas por comas o saltos de línea. |
results_limit | Opcional | Número máximo de publicaciones solicitadas para cada URL de grupo; el valor predeterminado es 100 y acepta enteros de 3 a 2,000. |
sort_by | Opcional | Orden opcional que se aplica a todos los grupos enviados: top_posts, recent_activity, chronological o chronological_listings. |
Cómo usar la Facebook Group Posts API
Envíe URL de grupos públicos con un orden opcional y un límite de resultados por grupo, y luego lea los resultados de la tarea asíncrona con paginación por cursor.
- Prepare una o más URL de grupos públicos de Facebook.
- Envíe urls, con results_limit y sort_by opcionales, por POST a /v1/facebook/group-posts y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea termine con éxito o devuelva un error.
- Lea data.results.items y solicite el next_cursor devuelto mientras has_more siga en true.
curl -X POST "https://api.socq.ai/v1/facebook/group-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.facebook.com/groups/1270525996445602/"],"results_limit":30,"sort_by":"recent_activity"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasos de uso de la Facebook Group Posts API
- Revisión de la actividad de grupos públicos: Use el orden recent_activity o chronological con los campos message, author, created_at y group_url para revisar las novedades públicas de grupos seleccionados.
- Archivos de debates de grupos: Almacene los ID de publicación, el texto del mensaje, el contexto del autor, las URL de origen, las horas de publicación y las horas de recopilación como registros públicos de grupos con autoría atribuible.
- Comparación de interacción en igualdad de condiciones: Aplique el mismo sort_by a todas las URL de grupos y compare reactions_count, comments_count y views_count bajo un mismo orden.
Consejos de expertos para la Facebook Group Posts API
- Envíe URL directas de grupos públicos y no el nombre de un grupo, para que cada entrada quede ligada a una fuente inequívoca.
- Calcule la profundidad solicitada como el número de urls multiplicado por results_limit, porque el límite se aplica a cada grupo por separado.
- Ejecute tareas separadas al comparar modos de orden, porque un solo valor de sort_by se aplica a todas las URL de grupos de una solicitud.
- Conserve juntos id y extra.group_url para que los registros posteriores sigan siendo atribuibles y se puedan deduplicar dentro de cada grupo.
- Trate el autor, el mensaje, la hora de publicación, los medios de video y las vistas de video como opcionales cuando una publicación pública no los expone.
- Siga results.next_cursor hasta que has_more sea false cuando la tarea completada contenga más de una página de resultados.
APIs relacionadas
Además de la Facebook Group Posts API, use estas APIs cuando necesite otro tipo de datos públicos de Facebook.
- Facebook Pages API — Obtiene perfiles públicos de páginas de Facebook, datos de contacto, imágenes y calificaciones visibles de la audiencia.
- Facebook Posts API — Recolecta publicaciones públicas, contenido multimedia, reacciones, comentarios y veces compartido desde URLs de Facebook compatibles.
- Facebook Comments API — Recolecta comentarios públicos, autores, interacción, contenido multimedia y enlaces de origen desde URLs de publicaciones.
- Facebook Video Transcript API — Extrae el texto de transcripción disponible y su formato desde URLs conocidas de videos o Reels públicos.
- Facebook Ad Transcript API — Extrae el texto hablado disponible, el idioma, el formato y el contexto de origen desde URLs de la Facebook Ad Library.
- Facebook Profile Photos API — Recolecta fotos públicas desde URLs de perfiles o páginas con descripciones, contexto del autor, interacción, metadatos de imagen y referencias de origen.