Snapchat Public Data API
Récupérez un Spotlight Snapchat public connu sous forme d’enregistrement normalisé, avec les champs disponibles de créateur, de légende, de média, d’audio, de date, de durée et d’engagement.
API Snapchat disponible
Utilisez Snapchat Spotlight lorsque vous disposez déjà de l’URL publique snapchat.com d’un Spotlight et que vous voulez ses détails disponibles dans un format de résultat standard.
Quelles données Snapchat pouvez-vous récupérer ?
SocQ convertit un Spotlight public connu en un enregistrement ReelVideoItem fixe, en ne conservant que les champs présents dans la réponse de la source.
Identité et source du Spotlight
Conservez l’ID de l’élément, l’URL publique d’origine, le type de ressource, la date de publication et la date de collecte, lorsqu’ils sont disponibles.
Légende et contexte du créateur
Obtenez le texte disponible ainsi que l’ID du créateur, son nom d’utilisateur, son nom affiché, l’URL de son profil, son avatar et les indicateurs de vérification et de confidentialité.
Vidéo, audio et taxonomie
Gardez dans l’enregistrement normalisé les références média, la durée, les métadonnées audio, le shortcode, les hashtags et les mentions disponibles.
Engagement visible
Capturez les nombres disponibles de mentions « J’aime », de commentaires, de partages, de lectures et de vues, comme valeurs publiques à un instant donné.
SocQ vs les outils de Snapchat
SocQ se concentre sur la consultation prise en charge du détail d’un Spotlight public, tandis que les applications et les outils créateurs ou entreprises de Snapchat servent des flux autorisés de publication, de compte, d’audience et de publicité.
| Fonctionnalité | SocQ | Outils de Snapchat |
|---|---|---|
| Usage principal | Récupérer le détail d’un Spotlight public connu | Créer, publier, gérer, analyser ou promouvoir des contenus autorisés |
| Authentification | Clé API SocQ | Compte Snapchat, application, jeton ou autorisation propre au produit |
| Entrée de départ | Une URL publique snapchat.com | Contexte de compte ou de produit autorisé |
| Publier ou gérer du contenu | Non pris en charge | Disponible dans le produit Snapchat concerné |
| Forme de la réponse | Enregistrement ReelVideoItem normalisé | Objets et interfaces Snapchat propres à chaque produit |
Fonctionnement de l’API Snapchat
Snapchat Spotlight repose sur une tâche asynchrone, suivie de la lecture du résultat stocké.
1. Envoyer une URL publique
Envoyez l’URL snapchat.com d’un Spotlight et conservez le task_id renvoyé.
2. Suivre la tâche
Interrogez /v1/tasks/{task_id} jusqu’à la réussite du traitement ou la signalisation d’un échec.
3. Lire le résultat stocké
Lisez data.results.items et n’utilisez next_cursor que si le lecteur de tâches commun signale d’autres enregistrements stockés.
Authentifiez-vous avec une clé API SocQ et envoyez l’URL d’un Spotlight public.
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.itemsCas d’usage courants de l’API Snapchat
Étude de contenus sélectionnés
Transformez l’URL d’un Spotlight choisi en un enregistrement traçable, prêt pour la relecture et l’annotation.
Enrichissement d’un catalogue
Ajoutez les champs disponibles de créateur, de légende, de média, d’audio, de durée, de taxonomie et d’horodatage à une collection de liens existante.
Instantanés d’engagement
Comparez les indicateurs visibles d’une collecte à l’autre, collected_at servant d’heure d’observation.
Limites et politique sur les données publiques
Les résultats Snapchat Spotlight sont des enregistrements publics à un instant donné et n’offrent aucune opération autorisée sur un compte Snapchat.
- La charge utile accepte exactement un champ url obligatoire et rejette les champs supplémentaires comme results_limit ou callback_url.
- La validation accepte snapchat.com et ses sous-domaines, mais n’impose aucun chemin ; utilisez un lien de Spotlight public, car des chemins sans rapport peuvent échouer chez le fournisseur.
- Le fournisseur effectue une seule consultation de détail et renvoie au plus un élément normalisé, pas un fil de Spotlights.
- La pagination des résultats stockés relève du lecteur de tâches commun et n’est pas la pagination de la source Snapchat.
- Les champs facultatifs de légende, de créateur, de média, de publication, d’audio, de durée, de taxonomie et d’indicateurs peuvent être null.
- L’endpoint ne se connecte pas, ne publie pas, ne modifie pas, ne supprime pas, ne modère pas, ne gère pas de comptes et n’exploite pas la publicité.
Questions fréquentes sur l’API Snapchat
Que récupère l’API Snapchat Spotlight ?
Elle récupère un Spotlight public connu et renvoie au plus un enregistrement normalisé, avec les champs source disponibles au moment de la collecte.
L’API Snapchat collecte-t-elle un fil de Spotlights ?
Non. L’endpoint actuel consulte un seul détail et n’accepte ni profil, ni terme de recherche, ni curseur, ni results_limit pour découvrir des contenus à la source.
Les nombres d’engagement renvoyés sont-ils en temps réel ?
Non. Considérez les nombres disponibles comme un instantané public capturé à collected_at, et non comme des statistiques complètes ou mises à jour en continu.
SocQ peut-il publier sur Snapchat ?
Non. Cet endpoint de données publiques n’offre ni connexion, ni publication, ni gestion de compte, ni modération, ni opérations publicitaires.
Comment Snapchat Spotlight est-il facturé ?
Chaque tâche réussie coûte un montant fixe de 0,19 crédit SocQ, quelle que soit la disponibilité des champs ou le nombre de résultats renvoyés.
Combinez les données de plusieurs plateformes pour des analyses métier plus complètes
Réunissez dans un même workflow les profils publics, les contenus et les données d’engagement de différentes plateformes pour suivre des marques, des créateurs et des sujets, et mener plus efficacement une veille et des analyses multiplateformes.
Twitch API
Transformez un nom d’utilisateur Twitch public connu en profil normalisé, collectez son inventaire de vidéos publiques ou récupérez un clip avec sa vidéo téléchargeable pour l’étude des créateurs, l’enrichissement de catalogues, la comparaison et le suivi par instantanés.
Rednote API
Récupérez des profils et des notes publics, recherchez des notes ou des utilisateurs, collectez les commentaires et leurs réponses imbriquées, et capturez une page de recommandations de la page d’accueil.
Kwai API
Récupérez des profils Kwai publics, une page de publications d’un compte ou une publication connue, avec identité, contenu, médias, horodatages et engagement visible normalisés.
Truth Social API
Récupérez les détails d’un compte public, collectez une page source de publications d’un compte ou transformez l’URL d’une publication connue en enregistrements normalisés.
Google Ad Library API
Découvrez des annonceurs publics, collectez les créations d’une entreprise ou récupérez par URL une création connue du Transparency Center, pour la recherche et la vérification.
Google Maps API
Découvrez des lieux publics, récupérez des détails normalisés à partir d’URL Maps connues et collectez des avis publics avec le contexte du lieu et de l’auteur relié à la source.


