snapchat/
spotlight

Obtenga un Snapchat Spotlight público a partir de una URL conocida de snapchat.com, con creador, descripción, contenido multimedia, audio, fecha, duración e interacción visible normalizados cuando están disponibles.

Snapchat Spotlight API

URL de un solo Spotlight
Contexto del creador
Instantánea del video
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

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ámetrosObligatorioDescripción
urlObligatorioURL 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.

  1. Copie una URL pública de Snapchat Spotlight de snapchat.com o de uno de sus subdominios.
  2. Envíe la URL como url a /v1/snapchat/spotlight y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea tenga éxito o informe un error.
  4. 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 only

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

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

Explorar otras plataformas

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

Snapchat Spotlight API — FAQ

Snapchat Spotlight API es una interfaz programática para obtener un Spotlight público a partir de una URL conocida de Snapchat como un registro de video normalizado.

Envíe una URL http o https no vacía cuyo host sea snapchat.com o un subdominio como www.snapchat.com; el runtime no exige una ruta específica, pero el proveedor espera un enlace público de Spotlight.

No. La entrada acepta únicamente url y realiza una sola consulta de detalle, por lo que no descubre un feed ni acepta results_limit.

El lector compartido de tareas expone limit, next_cursor y has_more para los registros almacenados; esos campos no convierten la consulta de Spotlight subyacente en una solicitud paginada en el origen.

No. Obtiene datos públicos admitidos y no inicia sesión, publica, edita, elimina, modera, administra cuentas ni opera la publicidad de Snapchat.

Cada tarea exitosa cuesta una tarifa fija de 0.19 créditos de SocQ, sin importar la disponibilidad de los campos devueltos ni la cantidad de resultados.