snapchat/
spotlight-comments

Recopile una página de origen de comentarios públicos de una URL de Snapchat Spotlight, con texto, autor, referencia de hilo, fecha e interacción visible normalizados.

Snapchat Spotlight Comments API

Entrada de URL de Spotlight
Una página de origen
Comentarios normalizados
0.19 créditos por solicitud
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

Snapchat Spotlight Comments

Los comentarios de Snapchat Spotlight son respuestas públicas asociadas con un elemento de Spotlight específico. SocQ almacena cada respuesta devuelta como un CommentItem con la identidad de origen, el texto del comentario, el contexto del autor disponible, las referencias al comentario padre y a la publicación, las horas de publicación y de recopilación, y los conteos visibles de Me gusta o respuestas.

Funcionalidades de la Snapchat Spotlight Comments API

  • Una URL de Spotlight por tareaEnvíe una url no vacía de snapchat.com o de un subdominio de Snapchat; el proveedor solicita una página de origen para ese destino.
  • Registros de comentarios normalizadosLea los ID de comentario, el texto, las URL de origen, las fechas y la identidad del autor disponible en la estructura de resultado estable CommentItem 1.0.
  • Contexto de hilo e interacciónConserva parent_id, post_id, likes_count y replies_count cuando el origen los expone, sin tratar los campos ausentes como cero ni como una cobertura completa del hilo.

Parámetros de la Snapchat Spotlight Comments API

ParámetrosObligatorioDescripción
urlObligatorioURL de Snapchat obligatoria y no vacía. La validación del runtime acepta snapchat.com y sus subdominios; use una URL pública canónica /@username/spotlight/{spotlight_id} para que el proveedor reciba el recurso Spotlight previsto.

Cómo usar la Snapchat Spotlight Comments API

Envíe una URL pública de Snapchat Spotlight, siga la tarea asíncrona y lea los comentarios normalizados almacenados con la paginación de resultados de la tarea.

  1. Copie la URL pública canónica de Snapchat Spotlight que quiere inspeccionar.
  2. Envíe url por POST a /v1/snapchat/spotlight-comments y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea tenga éxito o devuelva un error.
  4. Lea data.results.items; si el resultado almacenado de la tarea abarca varias páginas de respuesta de la API, continúe con next_cursor mientras has_more sea true.
curl -X POST "https://api.socq.ai/v1/snapchat/spotlight-comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.snapchat.com/@queenhaley_13/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYY2pnZnF0bG52AZslQsUdAZslQoRQAAAAAQ"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casos de uso de la Snapchat Spotlight Comments API

  • Revisión cualitativa de las respuestas: Revise el texto de los comentarios públicos devueltos y el contexto disponible del autor para identificar preguntas, reacciones y temas recurrentes en torno a un Spotlight seleccionado.
  • Archivos de comentarios vinculados al origen: Preserve los ID de comentario, las URL de origen, post_id, parent_id, published_at y collected_at para que cada respuesta almacenada conserve su procedencia disponible.
  • Instantáneas de interacción visible: Compare los likes_count y replies_count disponibles entre los comentarios devueltos, anclando cada observación a collected_at.

Consejos de expertos para la Snapchat Spotlight Comments API

  • Use la URL pública canónica /@username/spotlight/{spotlight_id}, aunque la validación del runtime comprueba el host de Snapchat y no exige esa ruta exacta.
  • No envíe cursor ni results_limit en el cuerpo del envío; este endpoint solo admite url y recopila una página del proveedor.
  • Trate parent_id y replies_count como contexto disponible, no como prueba de que los registros devueltos contengan un árbol de respuestas completo.
  • Permita que los ID, las URL, el texto, los campos del autor, published_at, parent_id, post_id y las métricas sean null cuando el origen no los proporciona.
  • Mantenga separada la profundidad de recopilación del proveedor de la paginación de GET /v1/tasks/{task_id}, cuyo cursor solo recorre los resultados que la tarea completada ya almacenó.

Además de la Snapchat Spotlight Comments API, use estas APIs cuando necesite otro tipo de datos públicos de Snapchat.

  • Snapchat Profile API
  • Snapchat Spotlight API — Obtiene un Spotlight público conocido de Snapchat con campos normalizados de creador, descripción, contenido multimedia, audio, marca de tiempo, duración e interacción visible, cuando están disponibles.

Explorar otras plataformas

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

Snapchat Spotlight Comments API — FAQ

Snapchat Spotlight Comments API es una interfaz programática para recopilar una página de origen de registros de comentarios públicos asociados con una URL de Snapchat Spotlight específica.

El contrato de envío acepta exactamente una cadena url obligatoria. La validación del runtime exige un host o subdominio de snapchat.com; use la forma pública canónica /@username/spotlight/{spotlight_id} para el recurso previsto.

No. El contrato de envío no tiene campos results_limit ni cursor, y la integración con el proveedor hace una sola solicitud de origen.

Ese cursor pertenece a GET /v1/tasks/{task_id}. Pagina los registros de comentarios ya almacenados de una tarea exitosa, con un límite de respuesta predeterminado de 50 y un rango aceptado de 1 a 500; no obtiene otra página de origen de Snapchat.

CommentItem 1.0 incluye id, platform, resource, type, url, published_at, collected_at, text, author, parent_id, post_id y metrics con likes_count y replies_count. Los campos anulables permanecen en null cuando no están disponibles.

Una tarea exitosa de Snapchat Spotlight Comments cuesta una tarifa fija de 0.19 créditos de SocQ, sin importar la cantidad de comentarios devueltos en esa única página de origen.