Snapchat Profile
Un perfil público de Snapchat puede exponer un nombre de usuario, un nombre visible, una biografía, un avatar, una portada, un sitio web, indicadores de cuenta, la ubicación y los conteos visibles del perfil. Esta consulta específica convierte un nombre de usuario conocido en una instantánea normalizada de la cuenta, útil para enriquecer, revisar o comparar más adelante.
Funcionalidades de la Snapchat Profile API
- Búsqueda exacta por nombre de usuarioResuelve un nombre de usuario de Snapchat conocido por tarea, con o sin una sola @ inicial, en lugar de buscar cuentas.
- Identidad de perfil normalizadaDevuelve el nombre de usuario, el nombre visible, la biografía, la URL pública y el identificador estable de origen disponibles en un registro AccountItem.
- Contenido multimedia y contexto del perfilMantiene por separado los campos disponibles de avatar, portada, sitio web y ubicación para flujos de visualización, indexación y enriquecimiento.
- Señales visibles de la cuentaCaptura los indicadores disponibles de verificación y privacidad, además de los conteos de seguidores, seguidos y publicaciones en el momento de la recopilación.
Parámetros de la Snapchat Profile API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
username | Obligatorio | Nombre de usuario de Snapchat obligatorio. Proporcione una @ inicial opcional seguida de 1–64 letras ASCII, dígitos, puntos, guiones bajos o guiones; se rechazan los espacios, las URL de perfil y otros caracteres. |
Cómo usar la Snapchat Profile API
Envíe un nombre de usuario aceptado, espere la tarea asíncrona y lea el resultado normalizado del perfil.
- Elija un nombre de usuario de Snapchat conocido con letras, dígitos, puntos, guiones bajos o guiones; una @ inicial es opcional.
- Envíe username a /v1/snapchat/profile y conserve el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea llegue a succeeded o failed.
- Tras el éxito, lea data.results.items; esta consulta de detalle normalmente devuelve un perfil o una lista vacía.
curl -X POST "https://api.socq.ai/v1/snapchat/profile" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"zane"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items after the task succeedsCasos de uso de la Snapchat Profile API
- Enriquecimiento de cuentas conocidas: Agregue la identidad pública, la biografía, el contenido multimedia del perfil, el sitio web y los conteos disponibles a un registro que ya contiene un nombre de usuario de Snapchat.
- Revisión de perfiles seleccionados: Presente una cuenta pública en una tarjeta de perfil o una cola de revisión coherente, sin mezclar historias, Spotlights ni acciones de administración de la cuenta.
- Comparación de instantáneas públicas: Almacene collected_at con los resultados sucesivos para comparar a lo largo del tiempo el texto público del perfil, los indicadores de cuenta, el contenido multimedia o los conteos visibles.
Consejos de expertos para la Snapchat Profile API
- Use la misma forma canónica del nombre de usuario en sus propios registros, aunque la solicitud acepte una @ inicial.
- Envíe exactamente un nombre de usuario por tarea; el procesamiento por lotes, las URL de perfil y results_limit quedan fuera del contrato de este endpoint.
- Trate la sintaxis aceptada como una validación de entrada, no como prueba de que el nombre de usuario corresponda a un perfil público accesible.
- Maneje el sitio web, la ubicación, el contenido multimedia del perfil, los indicadores de cuenta y cada métrica como campos opcionales.
- Conserve collected_at con cada resultado almacenado, porque el texto del perfil y los conteos visibles son valores de un momento dado.
APIs relacionadas
Además de la Snapchat Profile API, use estas APIs cuando necesite otro tipo de datos públicos de Snapchat.
- 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.
- Snapchat Spotlight Comments API