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.
| Funcionalidad | SocQ | Herramientas de producto de Snapchat |
|---|---|---|
| Uso principal | Obtener el detalle de un Spotlight público conocido | Crear, publicar, administrar, analizar o promocionar contenido autorizado |
| Autenticación | Clave de API de SocQ | Cuenta de Snapchat, app, token o autorización específica del producto |
| Entrada inicial | Una URL pública de snapchat.com | Contexto de cuenta o de producto autorizado |
| Publicar o administrar contenido | No compatible | Disponible en el producto de Snapchat correspondiente |
| Forma de la respuesta | Registro ReelVideoItem normalizado | Objetos 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. Enviar una URL pública
Envíe la URL de un Spotlight de snapchat.com y guarde el task_id devuelto.
2. Seguir la tarea
Consulte /v1/tasks/{task_id} hasta que el procesamiento se complete o informe un error.
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.
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.itemsCasos 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.
Combine datos de varias plataformas para obtener información de negocio más completa
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.
Twitch API
Convierta un nombre de usuario público conocido de Twitch en un perfil normalizado, recopile su inventario público de videos u obtenga un clip con su video descargable para investigación de creadores de contenido, enriquecimiento de catálogos, comparaciones y monitoreo mediante instantáneas.
Rednote API
Obtenga perfiles y notas públicos, busque notas o usuarios, recopile comentarios y respuestas anidadas, y capture una página de recomendaciones de inicio.
Kwai API
Obtenga perfiles públicos de Kwai, una página de publicaciones de una cuenta o una publicación conocida, con identidad, contenido, contenido multimedia, marcas de tiempo e interacción visible normalizados.
Truth Social API
Obtenga los datos de una cuenta pública, recopile una página de origen de publicaciones de una cuenta o convierta la URL de una publicación conocida en registros normalizados.
Google Ad Library API
Descubra anunciantes públicos, obtenga las creatividades de una empresa o consulte por URL una creatividad conocida del Transparency Center para investigación y revisión.
Google Maps API
Descubra lugares públicos, consulte detalles normalizados de URL conocidas de Maps y obtenga reseñas públicas con contexto del lugar y del autor vinculado a la fuente.


