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ètres | Obligatoire | Description |
|---|---|---|
url | Obligatoire | URL 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é.
- Copiez l’URL d’un Spotlight Snapchat public sur snapchat.com ou l’un de ses sous-domaines.
- Envoyez l’URL dans url à /v1/snapchat/spotlight et conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou signale un échec.
- 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 onlyCas 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.
API associées
En complément de la Snapchat Spotlight API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Snapchat.