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ámetros | Obligatorio | Descripción |
|---|---|---|
url | Obligatorio | URL 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.
- Copie la URL pública canónica de Snapchat Spotlight que quiere inspeccionar.
- Envíe url por POST a /v1/snapchat/spotlight-comments y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea tenga éxito o devuelva un error.
- 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 trueCasos 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ó.
APIs relacionadas
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.