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ètres | Obligatoire | Description |
|---|---|---|
url | Obligatoire | URL 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.
- Copiez l’URL publique canonique du Spotlight Snapchat que vous voulez examiner.
- Envoyez url en POST à /v1/snapchat/spotlight-comments et conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou renvoie un échec.
- 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 trueCas 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.
API associées
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.