Retour aux API
Données publiques Snapchat

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éSocQOutils de Snapchat
Usage principalRécupérer le détail d’un Spotlight public connuCréer, publier, gérer, analyser ou promouvoir des contenus autorisés
AuthentificationClé API SocQCompte Snapchat, application, jeton ou autorisation propre au produit
Entrée de départUne URL publique snapchat.comContexte de compte ou de produit autorisé
Publier ou gérer du contenuNon pris en chargeDisponible dans le produit Snapchat concerné
Forme de la réponseEnregistrement 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. 1. Envoyer une URL publique

    Envoyez l’URL snapchat.com d’un Spotlight et conservez le task_id renvoyé.

  2. 2. Suivre la tâche

    Interrogez /v1/tasks/{task_id} jusqu’à la réussite du traitement ou la signalisation d’un échec.

  3. 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.

Récupérer un Spotlight Snapchat

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.items

Cas 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.

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.