snapchat/
spotlight-comments

Collectez une page source de commentaires publics pour l’URL d’un Spotlight Snapchat, avec texte, auteur, référence de fil, horodatage et engagement visible, le tout normalisé.

Snapchat Spotlight Comments API

URL de Spotlight en entrée
Une seule page source
Commentaires normalisés
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 Comments

Les commentaires d’un Spotlight Snapchat sont des réponses publiques rattachées à un élément Spotlight précis. SocQ stocke chaque réponse renvoyée sous forme de CommentItem, avec l’identité source, le texte du commentaire, le contexte d’auteur disponible, les références du parent et de la publication, les dates de publication et de collecte, ainsi que les nombres visibles de mentions ou de réponses.

Fonctionnalités de la Snapchat Spotlight Comments API

  • Une URL de Spotlight par tâcheEnvoyez une seule url non vide sur snapchat.com ou l’un de ses sous-domaines ; le fournisseur demande une page source pour cette cible.
  • Enregistrements de commentaires normalisésLisez les ID de commentaires, le texte, les URL sources, les horodatages et l’identité de l’auteur lorsqu’elle est disponible, dans la structure de résultat stable CommentItem 1.0.
  • Contexte de fil et d’engagementConserve parent_id, post_id, likes_count et replies_count lorsque la source les expose, sans traiter un champ manquant comme zéro ni comme une couverture complète du fil.

Paramètres de la Snapchat Spotlight Comments API

ParamètresObligatoireDescription
urlObligatoireURL Snapchat obligatoire et non vide. La validation à l’exécution accepte snapchat.com et ses sous-domaines ; utilisez une URL publique canonique de la forme /@username/spotlight/{spotlight_id} pour que le fournisseur reçoive la ressource Spotlight visée.

Comment utiliser la Snapchat Spotlight Comments API

Envoyez l’URL d’un Spotlight Snapchat public, suivez la tâche asynchrone, puis lisez les commentaires normalisés enregistrés grâce à la pagination des résultats de tâche.

  1. Copiez l’URL publique canonique du Spotlight Snapchat que vous voulez examiner.
  2. Envoyez url en POST à /v1/snapchat/spotlight-comments et conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou renvoie un échec.
  4. Lisez data.results.items ; si le résultat de tâche enregistré s’étend sur plusieurs pages de réponse de l’API, poursuivez avec next_cursor tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/snapchat/spotlight-comments" \
  -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 and follow next_cursor while has_more is true

Cas d’usage de la Snapchat Spotlight Comments API

  • Relecture qualitative des réactions : Relisez le texte public des commentaires renvoyés et le contexte d’auteur disponible pour repérer les questions, les réactions et les thèmes récurrents autour d’un Spotlight choisi.
  • Archives de commentaires reliées à leur source : Gardez les ID de commentaires, les URL sources, post_id, parent_id, published_at et collected_at pour que chaque réponse stockée conserve la provenance disponible.
  • Instantanés d’engagement visible : Comparez les likes_count et replies_count disponibles entre les commentaires renvoyés, en ancrant chaque observation sur collected_at.

Conseils d’expert pour la Snapchat Spotlight Comments API

  • Utilisez l’URL publique canonique /@username/spotlight/{spotlight_id}, même si la validation à l’exécution contrôle l’hôte Snapchat sans imposer ce chemin exact.
  • N’envoyez ni cursor ni results_limit dans la charge utile de soumission : cet endpoint ne porte que url et collecte une seule page du fournisseur.
  • Voyez dans parent_id et replies_count un contexte disponible, non la preuve que les enregistrements renvoyés contiennent l’arbre complet des réponses.
  • Admettez que les ID, URL, texte, champs d’auteur, published_at, parent_id, post_id et métriques puissent être nuls quand la source ne les fournit pas.
  • Distinguez la profondeur de collecte du fournisseur de la pagination de GET /v1/tasks/{task_id}, dont le curseur ne parcourt que les résultats déjà stockés par la tâche terminée.

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

  • Snapchat Profile API
  • 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.

Explorer d’autres plateformes

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

Snapchat Spotlight Comments API — FAQ

Snapchat Spotlight Comments API est une interface programmatique qui collecte une page source d’enregistrements de commentaires publics associés à l’URL d’un Spotlight Snapchat donné.

La spécification de soumission accepte exactement une chaîne url obligatoire. La validation à l’exécution exige un hôte snapchat.com ou l’un de ses sous-domaines ; utilisez la forme publique canonique /@username/spotlight/{spotlight_id} pour la ressource visée.

Non. La spécification de soumission n’a ni results_limit ni champ cursor, et l’intégration du fournisseur effectue une seule requête source.

Ce curseur appartient à GET /v1/tasks/{task_id}. Il pagine les enregistrements de commentaires déjà stockés pour une tâche réussie, avec une limite de réponse de 50 par défaut et une plage acceptée de 1 à 500 ; il ne récupère pas une autre page source de Snapchat.

CommentItem 1.0 comprend id, platform, resource, type, url, published_at, collected_at, text, author, parent_id, post_id et metrics contenant likes_count et replies_count. Les champs pouvant être nuls le restent lorsqu’ils sont indisponibles.

Une tâche Snapchat Spotlight Comments réussie coûte 0,19 crédit SocQ fixe, quel que soit le nombre de commentaires renvoyés dans cette page source unique.