facebook/
group-posts

Recopile las publicaciones públicas de grupos de Facebook a partir de URL de grupos, con orden seleccionable, y obtenga texto, autores, marcas de tiempo, videos e interacción visible en registros normalizados.

Facebook Group Posts API

Publicaciones públicas de grupos
Cuatro modos de orden
Límite de resultados por grupo
1.2 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

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ámetrosObligatorioDescripción
urlsObligatorioURL obligatorias de grupos públicos de Facebook, separadas por comas o saltos de línea.
results_limitOpcionalNú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_byOpcionalOrden 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.

  1. Prepare una o más URL de grupos públicos de Facebook.
  2. Envíe urls, con results_limit y sort_by opcionales, por POST a /v1/facebook/group-posts y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea termine con éxito o devuelva un error.
  4. 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 true

Casos 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.

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.

Explorar otras plataformas

Combine los datos de Facebook con datos públicos de otras plataformas sociales compatibles.

Facebook Group Posts API — FAQ

Facebook Group Posts API es una interfaz programática que recupera las publicaciones públicas de una o más URL de grupos de Facebook, con ordenamiento opcional. Devuelve el texto de las publicaciones, los datos del autor, las marcas de tiempo, los medios de video, la interacción visible y la URL del grupo de origen, todo normalizado.

Envíe una o más URL de grupos públicos de Facebook en urls. Las listas de entrada vacías se rechazan y el contenido que la superficie pública del grupo no expone no puede aparecer en los resultados.

sort_by acepta top_posts, recent_activity, chronological o chronological_listings. El valor seleccionado se aplica a todas las URL de grupos de la solicitud.

results_limit tiene un valor predeterminado de 100, acepta enteros de 3 a 2,000 y se aplica por separado a cada URL de grupo. Dos URL con results_limit 30 solicitan hasta 60 publicaciones.

Un registro normalizado puede incluir id, url, message, author, reactions_count, comments_count, views_count, medios de video, created_at, collected_at y extra.group_url. Los campos ausentes de la publicación pública quedan en null, en cero o vacíos según su tipo normalizado.

Lea data.results.items desde GET /v1/tasks/{task_id}. Cuando has_more sea true, pase results.next_cursor como cursor en la siguiente solicitud de la tarea; cada página acepta un limit de 1 a 500.

Cada registro de publicación de grupo devuelto cuesta 1.2 créditos de SocQ. La estimación de la solicitud usa urls multiplicado por results_limit, y un conjunto de resultados vacío no genera cargo por resultado.