Snapchat Spotlight
Un registro público de Snapchat Spotlight puede contener un enlace de origen, una descripción, la identidad del creador, referencias multimedia, la hora de publicación, la duración, datos del audio y los conteos visibles de interacción. El resultado normalizado conserva esos campos disponibles con una marca de tiempo de recopilación, para revisar videos seleccionados, enriquecer catálogos y comparar en un momento dado.
Funcionalidades de la Snapchat Spotlight API
- Resolución de un Spotlight conocidoEnvíe una URL pública de snapchat.com y resuelva la respuesta de detalle correspondiente en, como máximo, un registro estándar, sin expandir un feed.
- Contexto del creador y del videoConserva la URL de origen y la descripción, la identidad del autor, el contenido multimedia, la duración, el audio, los hashtags, las menciones y la hora de publicación disponibles en una estructura de resultado fija.
- Instantánea de la interacción visibleDevuelve los Me gusta, comentarios, veces compartido, reproducciones y vistas disponibles junto con collected_at, para que el análisis posterior conserve la hora de observación.
Parámetros de la Snapchat Spotlight API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
url | Obligatorio | URL http o https obligatoria y no vacía cuyo host sea snapchat.com o cualquiera de sus subdominios. El runtime no impone ninguna regla sobre la ruta; use un enlace público de Spotlight como /@username/spotlight/{spotlight_id}. |
Cómo usar la Snapchat Spotlight API
Envíe una URL pública de Snapchat Spotlight, siga la tarea asíncrona y lea su resultado normalizado almacenado.
- Copie una URL pública de Snapchat Spotlight de snapchat.com o de uno de sus subdominios.
- Envíe la URL como url a /v1/snapchat/spotlight y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea tenga éxito o informe un error.
- Lea data.results.items; si la respuesta del resultado almacenado devuelve has_more, continúe con su next_cursor.
curl -X POST "https://api.socq.ai/v1/snapchat/spotlight" \
-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; next_cursor paginates stored results onlyCasos de uso de la Snapchat Spotlight API
- Revisar un Spotlight seleccionado: Convierta un enlace público conocido en un registro trazable con el origen, la descripción, el autor, el contenido multimedia, la fecha y los campos de interacción disponibles.
- Enriquecer un catálogo de contenido: Agregue a una lista de URL existente la identidad normalizada del video, el contexto del creador, la duración, el audio, los hashtags, las menciones y la hora de recopilación.
- Comparar la interacción capturada: Combine los conteos visibles con collected_at al comparar observaciones separadas, sin tratar los valores como datos en vivo ni completos.
Consejos de expertos para la Snapchat Spotlight API
- Envíe exactamente una URL en url; este endpoint no acepta arreglos, results_limit, usernames ni callback_url.
- Use un enlace público de Spotlight, aunque la validación comprueba el host de Snapchat y no exige una ruta; las rutas de Snapchat que no correspondan pueden fallar en el proveedor.
- No trate el next_cursor del resultado de la tarea como paginación del feed de origen, porque la consulta al proveedor es una única solicitud de detalle con, como máximo, un registro.
- Permita que los ID, las descripciones, los campos del autor, el contenido multimedia, las fechas, el audio y cada métrica sean null cuando la respuesta pública los omite.
- Almacene collected_at junto a los conteos de interacción para que cada medición siga ligada a su hora de recopilación.
- Prevea 0.19 créditos por cada tarea exitosa; la facturación fija no cambia con los campos devueltos ni con la cantidad de resultados.
APIs relacionadas
Además de la Snapchat Spotlight API, use estas APIs cuando necesite otro tipo de datos públicos de Snapchat.