snapchat/
spotlight

Récupérez un Spotlight Snapchat public à partir d’une URL snapchat.com connue, avec créateur, légende, médias, audio, horodatage, durée et engagement visible normalisés, lorsqu’ils sont disponibles.

Snapchat Spotlight API

URL d’un seul Spotlight
Contexte du créateur
Instantané vidéo
0,19 crédit par requête
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

Snapchat Spotlight

Un enregistrement de Spotlight Snapchat public peut contenir un lien source, une légende, l’identité du créateur, des références de médias, une date de publication, une durée, des informations audio et des nombres d’engagement visibles. Le résultat normalisé garde ces champs disponibles avec un horodatage de collecte, pour examiner une vidéo choisie, enrichir un catalogue et comparer des états à un instant donné.

Fonctionnalités de la Snapchat Spotlight API

  • Résolution d’un Spotlight connuEnvoyez une URL snapchat.com publique et résolvez la réponse de détail correspondante en au plus un enregistrement standard, sans explorer de fil.
  • Contexte du créateur et de la vidéoGarde l’URL source ainsi que la légende, l’identité de l’auteur, les médias, la durée, l’audio, les hashtags, les mentions et la date de publication disponibles dans une structure de résultat fixe.
  • Instantané d’engagement visibleRenvoie les mentions, commentaires, partages, lectures et vues disponibles avec collected_at, pour que l’analyse en aval conserve le moment de l’observation.

Paramètres de la Snapchat Spotlight API

ParamètresObligatoireDescription
urlObligatoireURL http ou https obligatoire et non vide dont l’hôte est snapchat.com ou l’un de ses sous-domaines. L’exécution n’impose aucune règle de chemin ; utilisez un lien Spotlight public, par exemple /@username/spotlight/{spotlight_id}.

Comment utiliser la Snapchat Spotlight API

Envoyez l’URL d’un Spotlight Snapchat public, suivez la tâche asynchrone, puis lisez le résultat normalisé enregistré.

  1. Copiez l’URL d’un Spotlight Snapchat public sur snapchat.com ou l’un de ses sous-domaines.
  2. Envoyez l’URL dans url à /v1/snapchat/spotlight et conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou signale un échec.
  4. Lisez data.results.items ; si la réponse sur les résultats enregistrés renvoie has_more, poursuivez avec son next_cursor.
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; next_cursor paginates stored results only

Cas d’usage de la Snapchat Spotlight API

  • Examiner un Spotlight choisi : Transformez un lien public connu en enregistrement traçable, avec la source, la légende, l’auteur, les médias, la date et les champs d’engagement disponibles.
  • Enrichir un catalogue de contenus : Ajoutez l’identité normalisée de la vidéo, le contexte du créateur, la durée, l’audio, les hashtags, les mentions et l’heure de collecte à une liste d’URL existante.
  • Comparer l’engagement relevé : Associez les nombres visibles à collected_at quand vous comparez des observations distinctes, sans les prendre pour des valeurs en direct ni complètes.

Conseils d’expert pour la Snapchat Spotlight API

  • Envoyez exactement une URL dans url : les tableaux, results_limit, usernames et callback_url ne sont pas acceptés par cet endpoint.
  • Utilisez un lien Spotlight public, même si la validation contrôle l’hôte Snapchat sans imposer de chemin ; des chemins Snapchat sans rapport peuvent échouer chez le fournisseur.
  • Ne voyez pas dans le next_cursor du résultat de tâche une pagination du fil source, car la recherche chez le fournisseur est une requête de détail unique qui donne au plus un enregistrement.
  • Admettez que les ID, légendes, champs d’auteur, médias, horodatages, audio et métriques individuelles puissent être nuls quand la réponse publique les omet.
  • Stockez collected_at à côté des nombres d’engagement, pour que chaque mesure reste liée à son moment de collecte.
  • Prévoyez 0,19 crédit par tâche réussie ; la facturation fixe ne varie ni avec les champs renvoyés ni avec le nombre de résultats.

En complément de la Snapchat Spotlight API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Snapchat.

Explorer d’autres plateformes

Combinez les données Snapchat avec les données publiques d’autres plateformes sociales prises en charge.

Snapchat Spotlight API — FAQ

Snapchat Spotlight API est une interface programmatique qui récupère un Spotlight public à partir d’une URL Snapchat connue, sous forme d’enregistrement vidéo normalisé.

Envoyez une URL http ou https non vide dont l’hôte est snapchat.com ou un sous-domaine tel que www.snapchat.com ; l’exécution n’impose pas de chemin précis, mais le fournisseur attend un lien Spotlight public.

Non. L’entrée n’accepte que url et effectue une seule recherche de détail ; elle ne découvre donc aucun fil et n’accepte pas results_limit.

Le lecteur de tâches commun expose limit, next_cursor et has_more pour les enregistrements stockés ; ces champs ne font pas de la recherche Spotlight sous-jacente une requête paginée à la source.

Non. Il récupère des données publiques prises en charge, et ne se connecte pas, ne publie pas, ne modifie pas, ne supprime pas, ne modère pas, ne gère aucun compte et n’exploite pas la publicité Snapchat.

Chaque tâche réussie coûte 0,19 crédit SocQ fixe, quels que soient les champs renvoyés ou le nombre de résultats.