Snapchat Profile
Un profil public Snapchat peut exposer un nom d’utilisateur, un nom affiché, une biographie, un avatar, une image de couverture, un site web, des indicateurs de compte, une localisation et des nombres de profil visibles. Cette recherche ciblée transforme un nom d’utilisateur connu en instantané de compte normalisé, pour l’enrichissement, la relecture ou une comparaison ultérieure.
Fonctionnalités de la Snapchat Profile API
- Recherche exacte par nom d’utilisateurRésout un seul nom d’utilisateur Snapchat connu par tâche, avec ou sans un @ initial, plutôt que de chercher des comptes.
- Identité de profil normaliséeRenvoie le nom d’utilisateur, le nom affiché, la biographie, l’URL publique et l’identifiant source stable, lorsqu’ils sont disponibles, dans un enregistrement AccountItem.
- Médias et contexte du profilGarde séparés l’avatar, l’image de couverture, le site web et la localisation disponibles, pour l’affichage, l’indexation et les workflows d’enrichissement.
- Signaux de compte visiblesCapture au moment de la collecte les indicateurs de vérification et de confidentialité disponibles, ainsi que les nombres d’abonnés, d’abonnements et de publications.
Paramètres de la Snapchat Profile API
| Paramètres | Obligatoire | Description |
|---|---|---|
username | Obligatoire | Nom d’utilisateur Snapchat obligatoire. Indiquez un @ initial facultatif suivi de 1–64 lettres ASCII, chiffres, points, tirets bas ou traits d’union ; les espaces, les URL de profil et les autres caractères sont rejetés. |
Comment utiliser la Snapchat Profile API
Envoyez un nom d’utilisateur accepté, attendez la tâche asynchrone, puis lisez le profil normalisé qu’elle renvoie.
- Choisissez un nom d’utilisateur Snapchat connu, composé de lettres, de chiffres, de points, de tirets bas ou de traits d’union ; un @ initial est facultatif.
- Envoyez username à /v1/snapchat/profile et conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche atteigne succeeded ou failed.
- Après le succès, lisez data.results.items ; cette recherche de détail renvoie normalement un profil ou une liste vide.
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 succeedsCas d’usage de la Snapchat Profile API
- Enrichissement de comptes connus : Ajoutez l’identité publique, la biographie, les médias du profil, le site web et les nombres disponibles à un enregistrement qui contient déjà un nom d’utilisateur Snapchat.
- Relecture de profils sélectionnés : Présentez un compte public dans une fiche de profil ou une file de relecture homogène, sans y mêler les Stories, les Spotlights ni les actions de gestion de compte.
- Comparaison d’instantanés publics : Stockez collected_at avec chaque résultat successif pour comparer dans le temps le texte public du profil, les indicateurs de compte, les médias ou les nombres visibles.
Conseils d’expert pour la Snapchat Profile API
- Gardez la même forme canonique de nom d’utilisateur dans vos propres enregistrements, même si la requête accepte un @ initial.
- Envoyez exactement un nom d’utilisateur par tâche : les lots, les URL de profil et results_limit sortent du cadre de cet endpoint.
- Voyez dans la syntaxe acceptée une simple validation d’entrée, non la preuve que le nom d’utilisateur mène à un profil public accessible.
- Gérez le site web, la localisation, les médias du profil, les indicateurs de compte et chaque métrique comme des champs facultatifs.
- Conservez collected_at avec chaque résultat stocké, car le texte du profil et les nombres visibles sont des valeurs à un instant donné.
API associées
En complément de la Snapchat Profile API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Snapchat.
- Snapchat Spotlight API — Récupérez un Spotlight Snapchat public connu avec créateur, légende, médias, audio, horodatage, durée et engagement visible normalisés, lorsqu’ils sont disponibles.
- Snapchat Spotlight Comments API