Volver a las API
Datos públicos de Snapchat

Snapchat Public Data API

Obtenga un Spotlight público conocido de Snapchat como un registro normalizado con los campos disponibles de creador, descripción, multimedia, audio, marca de tiempo, duración e interacción.

API de Snapchat disponible

Use Snapchat Spotlight cuando ya tenga la URL pública de un Spotlight de snapchat.com y necesite sus detalles disponibles en una estructura de resultado estándar.

¿Qué datos de Snapchat se pueden obtener?

SocQ convierte un Spotlight público conocido en un registro ReelVideoItem fijo y conserva solo los campos disponibles en la respuesta de origen.

Identidad y origen del Spotlight

Conserve el ID del elemento, la URL pública original, el tipo de recurso, la fecha de publicación y el momento de recopilación, cuando estén disponibles.

Descripción y contexto del creador

Obtenga el texto disponible junto con el ID del creador, el nombre de usuario, el nombre visible, la URL del perfil, el avatar y los indicadores de verificación y privacidad.

Video, audio y taxonomía

Conserve en el registro normalizado las referencias multimedia, la duración, los metadatos de audio, el shortcode, los hashtags y las menciones disponibles.

Interacción visible

Capture los conteos disponibles de Me gusta, comentarios, veces compartido, reproducciones y vistas como valores públicos de un momento determinado.

SocQ vs herramientas de producto de Snapchat

SocQ se centra en la consulta compatible de detalles públicos de un Spotlight, mientras que las apps de Snapchat y sus herramientas para creadores y empresas atienden flujos autorizados de publicación, cuenta, audiencia y publicidad.

FuncionalidadSocQHerramientas de producto de Snapchat
Uso principalObtener el detalle de un Spotlight público conocidoCrear, publicar, administrar, analizar o promocionar contenido autorizado
AutenticaciónClave de API de SocQCuenta de Snapchat, app, token o autorización específica del producto
Entrada inicialUna URL pública de snapchat.comContexto de cuenta o de producto autorizado
Publicar o administrar contenidoNo compatibleDisponible en el producto de Snapchat correspondiente
Forma de la respuestaRegistro ReelVideoItem normalizadoObjetos e interfaces de Snapchat específicos de cada producto

Cómo funciona la API de Snapchat

Snapchat Spotlight usa una tarea asíncrona seguida de la obtención del resultado almacenado.

  1. 1. Enviar una URL pública

    Envíe la URL de un Spotlight de snapchat.com y guarde el task_id devuelto.

  2. 2. Seguir la tarea

    Consulte /v1/tasks/{task_id} hasta que el procesamiento se complete o informe un error.

  3. 3. Leer el resultado almacenado

    Lea data.results.items y use next_cursor solo si el lector de tareas compartido indica que hay más registros almacenados.

Obtener un Spotlight de Snapchat

Autentíquese con una clave de API de SocQ y envíe la URL de un Spotlight público.

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

Casos de uso frecuentes de la API de Snapchat

Investigación de contenido seleccionado

Convierta la URL de un Spotlight elegido en un registro rastreable para su revisión y anotación.

Enriquecimiento de catálogos

Agregue a una colección de enlaces existente los campos disponibles de creador, descripción, multimedia, audio, duración, taxonomía y marca de tiempo.

Instantáneas de interacción

Compare las métricas visibles entre recopilaciones distintas y conserve collected_at como momento de la observación.

Límites y política de datos públicos

Los resultados de Snapchat Spotlight son registros públicos de un momento determinado y no ofrecen operaciones autorizadas de cuentas de Snapchat.

  • La carga útil acepta exactamente un url obligatorio y rechaza campos adicionales como results_limit o callback_url.
  • La validación acepta snapchat.com y sus subdominios, pero no exige una ruta concreta; use un enlace público de Spotlight, porque las rutas no relacionadas pueden fallar en el proveedor.
  • El proveedor realiza una sola consulta de detalle y devuelve como máximo un elemento normalizado, no un feed de Spotlight.
  • La paginación de resultados almacenados corresponde al lector de tareas compartido y no es paginación de origen de Snapchat.
  • Los campos opcionales de descripción, creador, multimedia, publicación, audio, duración, taxonomía y métricas pueden ser null.
  • El endpoint no inicia sesión, ni publica, edita, elimina, modera, administra cuentas ni opera publicidad.

Preguntas frecuentes sobre la API de Snapchat

¿Qué obtiene la API de Snapchat Spotlight?

Obtiene un Spotlight público conocido y devuelve como máximo un registro normalizado con los campos de origen disponibles en el momento de la recopilación.

¿La API de Snapchat recopila un feed de Spotlight?

No. El endpoint actual es una consulta de un solo detalle y no acepta un perfil, un término de búsqueda, un cursor ni results_limit para el descubrimiento de origen.

¿Los conteos de interacción devueltos son en tiempo real?

No. Trate los conteos disponibles como una instantánea pública capturada en collected_at, no como analítica completa ni actualizada de forma continua.

¿SocQ puede publicar en Snapchat?

No. Este endpoint de datos públicos no ofrece inicio de sesión, publicación, administración de cuentas, moderación ni operaciones de publicidad.

¿Cuánto cuesta Snapchat Spotlight?

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

Reúna en un mismo flujo de trabajo perfiles públicos, contenido y datos de interacción de distintas plataformas para dar seguimiento a marcas, creadores y temas, y para realizar monitoreo y análisis entre plataformas con más eficiencia.