SNSTrackerSNSTracker

Référence de l’API

Aperçu

L’API SNSTracker vous permet de gérer par programmation les flux et les canaux de surveillance. Vous pouvez créer des flux (vidéos, publications, etc.) et des canaux (comptes, profils), les actualiser pour obtenir les données les plus récentes et recevoir des notifications en temps réel via des webhooks.

Authentification

Toutes les requêtes API nécessitent une authentification via une clé API. Incluez votre clé API dans l’en-tête X-API-Key.

Comment obtenir votre clé API :

  1. Connectez-vous à SNSTracker
  2. Allez dans Paramètres → Clés API
  3. Créez une nouvelle clé API ou utilisez une clé existante
  4. Copiez la clé API (vous ne la verrez qu’une seule fois lors de la création)

Points de terminaison de l’API

1. Créer des flux

Créez des flux de surveillance en soumettant des URL de flux (vidéos, publications, etc.).

POST /api/v1/feeds

Requête

En-têtes :

  • X-API-Key: Votre clé API (obligatoire)
  • Content-Type: application/json

Corps de la requête :

{
  "urls": [
    "https://www.tiktok.com/@user/video/1234567890",
    "https://www.instagram.com/p/ABC123/"
  ],
  "collectionId": "coll_abc123xyz"
}

Paramètres :

  • urls (obligatoire) : Tableau d’URL de flux à surveiller. Maximum 200 URL par requête.
  • collectionId (facultatif) : ID de collection où les flux seront ajoutés. Si non fourni, la collection par défaut de votre équipe sera utilisée.

Réponse

Réponse de succès (200) :

{
  "code": 0,
  "message": "ok",
  "data": {
    "success": 2,
    "failed": 0,
    "total": 2,
    "results": [
      {
        "index": 0,
        "url": "https://www.tiktok.com/@user/video/1234567890",
        "platform": "tiktok",
        "feedId": "feed_abc123xyz",
        "success": true
      },
      {
        "index": 1,
        "url": "https://www.instagram.com/p/ABC123/",
        "platform": "instagram",
        "feedId": "feed_def456uvw",
        "success": true
      }
    ],
    "errors": [],
    "message": "Flux créés avec succès. Les données seront mises à jour sous peu."
  }
}

Champs de réponse :

  • success : Nombre de flux créés avec succès
  • failed : Nombre d’échecs de création de flux
  • total : Nombre total d’URL fournies
  • results : Tableau de résultats pour chaque URL
    • index : Index basé sur zéro dans le tableau de la requête
    • url : URL validée et standardisée
    • platform : Plateforme détectée (tiktok, instagram, youtube, etc.)
    • feedId : Identifiant unique du flux créé
    • success : Indique si le flux a été créé avec succès
    • skipped : (facultatif) Indique si le flux a été ignoré car il existe déjà
    • resumed : (facultatif) Indique si un flux arrêté a été repris
    • error : (facultatif) Message d’erreur en cas d’échec
  • errors : Tableau des erreurs pour les URL en échec

Exemple de requête

curl -X POST https://snstracker.com/api/v1/feeds \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": [
      "https://www.tiktok.com/@user/video/1234567890"
    ]
  }'

2. Actualiser des flux

Actualisez des flux existants pour obtenir immédiatement les données les plus récentes. Seuls les flux avec le statut "Pending" ou "Tracked" peuvent être actualisés.

POST /api/v1/feeds/refresh

Requête

En-têtes :

  • X-API-Key: Votre clé API (obligatoire)
  • Content-Type: application/json

Corps de la requête :

{
  "feedIds": ["feed_abc123xyz", "feed_def456uvw"]
}

Paramètres :

  • feedIds (obligatoire) : Tableau d’ID de flux à actualiser

Réponse

Réponse de succès (200) :

{
  "code": 0,
  "message": "ok",
  "data": {
    "success": true,
    "feedIds": ["feed_abc123xyz", "feed_def456uvw"],
    "total": 2,
    "message": "2 flux actualisé(s) avec succès"
  }
}

Champs de réponse :

  • success : Indique si l’opération d’actualisation a réussi
  • feedIds : Tableau des ID de flux actualisés
  • total : Nombre de flux actualisés
  • message : Message de réussite

Exemple de requête

curl -X POST https://snstracker.com/api/v1/feeds/refresh \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "feedIds": ["feed_abc123xyz"]
  }'

3. Créer des canaux

Créez des canaux de surveillance en soumettant des URL de canal (profils de compte, etc.).

Channel pricing note: Xiaohongshu channel tasks are priced separately from the default channel task price and currently cost 10 credits per successful request.

POST /api/v1/channels

Requête

En-têtes :

  • X-API-Key: Votre clé API (obligatoire)
  • Content-Type: application/json

Corps de la requête :

{
  "urls": [
    "https://www.tiktok.com/@username",
    "https://www.instagram.com/username/"
  ],
  "collectionId": "coll_abc123xyz"
}

Paramètres :

  • urls (obligatoire) : Tableau d’URL de canaux à surveiller. Maximum 5 URL par requête.
  • collectionId (facultatif) : ID de collection où les canaux seront ajoutés. Si non fourni, la collection par défaut de votre équipe sera utilisée.

Réponse

Réponse de succès (200) :

{
  "code": 0,
  "message": "ok",
  "data": {
    "success": 2,
    "failed": 0,
    "total": 2,
    "results": [
      {
        "index": 0,
        "url": "https://www.tiktok.com/@username",
        "platform": "tiktok",
        "channelId": "channel_abc123xyz",
        "success": true
      },
      {
        "index": 1,
        "url": "https://www.instagram.com/username/",
        "platform": "instagram",
        "channelId": "channel_def456uvw",
        "success": true
      }
    ],
    "errors": [],
    "message": "Canaux créés avec succès. Les données seront mises à jour sous peu."
  }
}

Champs de réponse :

  • success : Nombre de canaux créés avec succès
  • failed : Nombre d’échecs de création de canaux
  • total : Nombre total d’URL fournies
  • results : Tableau de résultats pour chaque URL
    • index : Index basé sur zéro dans le tableau de la requête
    • url : URL validée et standardisée
    • platform : Plateforme détectée (tiktok, instagram, youtube, etc.)
    • channelId : Identifiant unique du canal créé
    • success : Indique si le canal a été créé avec succès
    • skipped : (facultatif) Indique si le canal a été ignoré car il existe déjà
    • resumed : (facultatif) Indique si un canal arrêté a été repris
    • error : (facultatif) Message d’erreur en cas d’échec
  • errors : Tableau des erreurs pour les URL en échec

Exemple de requête

curl -X POST https://snstracker.com/api/v1/channels \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": [
      "https://www.tiktok.com/@username"
    ]
  }'

4. Actualiser des canaux

Actualisez des canaux existants pour obtenir immédiatement les données les plus récentes. Seuls les canaux avec le statut "Pending" ou "Tracked" peuvent être actualisés.

Channel pricing note: Xiaohongshu channel tasks are priced separately from the default channel task price and currently cost 10 credits per successful request.

POST /api/v1/channels/refresh

Requête

En-têtes :

  • X-API-Key: Votre clé API (obligatoire)
  • Content-Type: application/json

Corps de la requête :

{
  "channelIds": ["channel_abc123xyz", "channel_def456uvw"]
}

Paramètres :

  • channelIds (obligatoire) : Tableau d’ID de canaux à actualiser

Réponse

Réponse de succès (200) :

{
  "code": 0,
  "message": "ok",
  "data": {
    "success": true,
    "channelIds": ["channel_abc123xyz", "channel_def456uvw"],
    "total": 2,
    "message": "2 canal(aux) actualisé(s) avec succès"
  }
}

Champs de réponse :

  • success : Indique si l’opération d’actualisation a réussi
  • channelIds : Tableau des ID de canaux actualisés
  • total : Nombre de canaux actualisés
  • message : Message de réussite

Exemple de requête

curl -X POST https://snstracker.com/api/v1/channels/refresh \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "channelIds": ["channel_abc123xyz"]
  }'

5. Synchroniser un flux

Synchronisez les données d’un flux directement depuis le service de scraping. Ce point de terminaison récupère immédiatement les données les plus récentes du flux et consomme des crédits en cas de synchronisation réussie. Tous les membres et clés API d’une équipe partagent une seule limite pour tous les endpoints de synchronisation. La limite partagée est de 1 pour Starter ou sans abonnement valide, 5 pour Standard et 10 pour Premium.

⚠️ Note importante : Ce point de terminaison de synchronisation est autonome et ne s’intègre PAS à la plateforme web. Les opérations de synchronisation :

  • NE créent PAS et NE mettent PAS à jour les enregistrements de flux dans le tableau de bord web
  • **N’**apparaissent PAS dans votre liste de flux ni dans vos collections
  • NE déclenchent PAS de webhooks ni de notifications
  • NE font QUE renvoyer les données récupérées directement dans la réponse API

Ce point de terminaison est conçu pour une récupération ponctuelle des données via l’API. Pour créer des flux de surveillance persistants qui apparaissent dans la plateforme web, utilisez plutôt le point de terminaison Créer des flux.

POST /api/v1/feeds/sync

Requête

En-têtes :

  • X-API-Key: Votre clé API (obligatoire)
  • Content-Type: application/json

Corps de la requête :

{
  "url": "https://www.tiktok.com/@user/video/1234567890"
}

Paramètres :

  • url (obligatoire) : URL du flux à synchroniser. Doit être une chaîne valide et non vide.

Réponse

Réponse de succès (200) :

{
  "code": 0,
  "message": "ok",
  "data": {
    "success": true,
    "url": "https://www.tiktok.com/@user/video/1234567890",
    "feedInfo": {
      "feed_id": "1234567890",
      "platform": 1,
      "platform_name": "tiktok",
      "url": "https://www.tiktok.com/@user/video/1234567890",
      "views": 1000000,
      "likes": 200000,
      "comments": 1000,
      "shares": 2000,
      "bookmarks": 200,
      "engagement": 512000,
      "description": "Description de la vidéo",
      "hashtags": ["tag1", "tag2"],
      "publish_at": 1234567890
    }
  }
}

Champs de réponse :

  • success : Indique si l’opération de synchronisation a réussi
  • url : URL du flux synchronisé
  • feedInfo : Informations complètes du flux, y compris les métriques, la description, les hashtags, etc.

Réponses d’erreur :

  • 429 Too Many Requests: La limite partagée de l’équipe est atteinte. La requête n’est pas mise en attente.
  • 400 Bad Request : Crédits insuffisants ou URL invalide

Exemple de requête

curl -X POST https://snstracker.com/api/v1/feeds/sync \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.tiktok.com/@user/video/1234567890"
  }'

6. Synchroniser un canal

Synchronisez les données d’un canal directement depuis le service de scraping. Ce point de terminaison récupère immédiatement les données les plus récentes du canal et consomme des crédits en cas de synchronisation réussie. Tous les membres et clés API d’une équipe partagent une seule limite pour tous les endpoints de synchronisation. La limite partagée est de 1 pour Starter ou sans abonnement valide, 5 pour Standard et 10 pour Premium.

Channel pricing note: Xiaohongshu channel tasks are priced separately from the default channel task price and currently cost 10 credits per successful request.

⚠️ Note importante : Ce point de terminaison de synchronisation est autonome et ne s’intègre PAS à la plateforme web. Les opérations de synchronisation :

  • NE créent PAS et NE mettent PAS à jour les enregistrements de canaux dans le tableau de bord web
  • **N’**apparaissent PAS dans votre liste de canaux ni dans vos collections
  • NE déclenchent PAS de webhooks ni de notifications
  • NE font QUE renvoyer les données récupérées directement dans la réponse API

Ce point de terminaison est conçu pour une récupération ponctuelle des données via l’API. Pour créer des canaux de surveillance persistants qui apparaissent dans la plateforme web, utilisez plutôt le point de terminaison Créer des canaux.

POST /api/v1/channels/sync

Requête

En-têtes :

  • X-API-Key: Votre clé API (obligatoire)
  • Content-Type: application/json

Corps de la requête :

{
  "url": "https://www.tiktok.com/@username"
}

Paramètres :

  • url (obligatoire) : URL du canal à synchroniser. Doit être une chaîne valide et non vide.

Réponse

Réponse de succès (200) :

{
  "code": 0,
  "message": "ok",
  "data": {
    "success": true,
    "url": "https://www.tiktok.com/@username",
    "channelInfo": {
      "id": "1234567890",
      "platform": 1,
      "platform_name": "tiktok",
      "username": "username",
      "nickname": "Nom d’utilisateur",
      "description": "Description du canal",
      "followers": 1000000,
      "followings": 2000,
      "likes": 200000000,
      "total_count": 1000,
      "track_count": 1000,
      "status": 1
    }
  }
}

Champs de réponse :

  • success : Indique si l’opération de synchronisation a réussi
  • url : URL du canal synchronisé
  • channelInfo : Informations complètes du canal, y compris les métriques, la description, etc.

Réponses d’erreur :

  • 429 Too Many Requests: La limite partagée de l’équipe est atteinte. La requête n’est pas mise en attente.
  • 400 Bad Request : Crédits insuffisants ou URL invalide

Exemple de requête

curl -X POST https://snstracker.com/api/v1/channels/sync \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.tiktok.com/@username"
  }'

7. Synchroniser les publications d’un canal

Renvoie une page, avec 12 éléments maximum par requête pour Instagram et Reels, sans pagination automatique. instagram inclut images, vidéos et carrousels ; reels renvoie les vidéos Reels.

POST /api/v1/channels/feeds/sync
X-API-Key: your-api-key
Content-Type: application/json

Request and pagination

{
  "platform": "instagram",
  "channel_name": "instagram"
}
  • count est un entier positif facultatif indiquant le nombre souhaité d’éléments sur cette page, sans valeur par défaut. Les limites dépendent de la plateforme : Instagram et Reels renvoient au maximum 12 éléments par requête, parfois moins. Sans ce paramètre, la taille de page par défaut de la plateforme est utilisée.
  • Omettez cursor pour la première page. Pour la suivante, renvoyez exactement next_cursor avec les mêmes platform et channel_name. À la fin : has_more=false, next_cursor=null.
{
  "platform": "instagram",
  "channel_name": "instagram",
  "cursor": "previous-next-cursor"
}

Chaque page récupérée avec succès coûte 10 crédits, y compris les pages vides. Seules les requêtes échouées sont gratuites ; un solde initial de 10 crédits est requis. La limite simultanée de l’équipe est partagée avec les autres API de synchronisation. Aucun enregistrement de tableau de bord n’est créé.

Response example (placeholder cursor) — reels, lunacut.edit, count=1

{
  "code": 0,
  "message": "ok",
  "data": {
    "success": true,
    "platform": "reels",
    "channel_name": "lunacut.edit",
    "channel_url": "https://www.instagram.com/lunacut.edit/",
    "requested_count": 1,
    "returned_count": 1,
    "has_more": true,
    "next_cursor": "cursor-from-response",
    "items": [
      {
        "feed_id": "4009169989985582972",
        "platform": 5,
        "platform_name": "reels",
        "type": "video",
        "url": "https://www.instagram.com/reel/Dejbt1JPz98/",
        "author_username": "lunacut.edit",
        "publish_at": 1792150387,
        "duration": 70.077,
        "view_count": 310475
      }
    ]
  }
}

platform and channel_name are required. channel_name is the username, not the display name; leading @ is accepted and dots are preserved. requested_count is null when count is omitted; returned_count equals items.length. Unknown metrics/timestamps are null. Posts may lack timestamps and carousel details. items uses the existing feed fields, including video_url, image_urls and cover_url; the example shows only selected fields. publish_at is Unix seconds and duration is seconds. Upstream order is preserved, without a most-popular sorting option; deduplicate across pages by feed_id. Empty pages can still have a next cursor; a carousel counts as one post.

Les métriques de items, notamment les vues (view_count), mentions J’aime (like_count), enregistrements (bookmark_count) et commentaires (comment_count), dépendent de la plateforme et des données de sa liste de contenus. Certaines peuvent être indisponibles. Une métrique indisponible vaut null, ce qui ne signifie pas zéro.

Pour rechercher les métriques absentes de la liste, appelez séparément POST /api/v1/feeds/sync en passant l’url de l’élément dans le champ url du corps de la requête. Cette consultation détaillée est facturée séparément selon les règles de cet endpoint. Les résultats dépendent toujours des données fournies par la plateforme ; toutes les métriques manquantes ne sont pas nécessairement récupérables.

HTTP: 400 invalid input/cursor or insufficient initial credits; 401 invalid API key; 403 disabled team or inaccessible channel; 402 insufficient credits at settlement; 429 team concurrency limit (Retry-After: 1); 502 upstream/invalid page; 503 service unavailable; 504 timeout.

8. Obtenir les informations supplémentaires du profil

POST /api/v1/channels/about/sync

Instagram et Reels uniquement. Même entrée url obligatoire que /api/v1/channels/sync : https://www.instagram.com/lunacut.edit/ ou https://www.instagram.com/lunacut.edit/reels/. Aucun platform, count ou cursor requis. Les publications et autres plateformes ne sont pas acceptées.

curl -X POST https://snstracker.com/api/v1/channels/about/sync \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.instagram.com/lunacut.edit/"}'

Chaque requête réussie coûte 80 crédits, même si les champs sont null. Les erreurs ne sont pas facturées ; solde minimal de 80 crédits avant la requête. Concurrence partagée avec toutes les API synchrones de l’équipe : Starter/sans abonnement actif 1, Standard 5, Premium 10. Aucun enregistrement ni webhook créé.

Exemple de réponse ; disponibilité selon les informations publiques du compte.

{
  "code": 0,
  "message": "ok",
  "data": {
    "success": true,
    "url": "https://www.instagram.com/lunacut.edit/",
    "channelAbout": {
      "platform": 6,
      "platform_name": "instagram",
      "username": "lunacut.edit",
      "channel_url": "https://www.instagram.com/lunacut.edit/",
      "country": "Brazil",
      "country_visible": true,
      "date_joined": "2020-05",
      "date_joined_text": "May 2020"
    }
  }
}

country : pays/région public, uniquement si country_visible=true, pas une géolocalisation IP en temps réel. country_visible : visibilité, ou null si inconnue. date_joined : mois d’inscription (YYYY-MM), ou null si absent/non reconnu. date_joined_text : texte original ou null. Bio, abonnés et anciens noms exclus.

400 / 401 / 402 / 403 / 429 (Retry-After: 1) / 502 / 503 / 504.

Intégration des webhooks

SNSTracker prend en charge les webhooks pour recevoir des notifications en temps réel lorsque le contenu surveillé atteint les seuils que vous avez configurés. Vous pouvez configurer des webhooks pour recevoir des notifications concernant :

  • Mises à jour de flux : Lorsque les vues, l’engagement (likes + commentaires + partages) augmentent selon votre seuil
  • Mises à jour de canaux : Lorsque les abonnés, les abonnements ou les likes augmentent selon votre seuil

Configuration des webhooks

  1. Configurer les cibles de webhook dans les paramètres de vos collections
  2. Activer les notifications dans la configuration de votre collection
  3. Définir des seuils pour les métriques que vous souhaitez surveiller

Pour des instructions détaillées de configuration des webhooks, veuillez consulter le Guide de configuration des webhooks.

Réponses d’erreur

Tous les points de terminaison peuvent renvoyer les réponses d’erreur suivantes :

401 Unauthorized - Clé API manquante

{
  "code": -1,
  "message": "X-API-Key header is required"
}

401 Unauthorized - Clé API invalide

{
  "code": -1,
  "message": "Invalid API key"
}

400 Bad Request - Entrée invalide

{
  "code": -1,
  "message": "Invalid request: urls must be an array"
}

400 Bad Request - Trop d’URL (Créer des flux)

{
  "code": -1,
  "message": "Maximum 200 URLs allowed per request"
}

400 Bad Request - Trop d’URL (Créer des canaux)

{
  "code": -1,
  "message": "Maximum 200 URLs allowed per request"
}

400 Bad Request - Crédits insuffisants

{
  "code": -1,
  "message": "Insufficient credits. Required: 10, Available: 5"
}

429 Too Many Requests - Synchronisations simultanées par équipe

{
  "code": -1,
  "message": "Maximum concurrent sync requests (1) reached for this team. Currently active: 1. Wait for a request to complete, or contact official support to increase the limit."
}

403 Forbidden - Collection invalide

{
  "code": -1,
  "message": "Collection not found or does not belong to your team"
}

404 Not Found

{
  "code": -1,
  "message": "No feeds found"
}

ou

{
  "code": -1,
  "message": "No channels found"
}

Exemples d’utilisation

Exemple Python - Créer des flux

import requests

url = "https://snstracker.com/api/v1/feeds"
headers = {
    "X-API-Key": "your-api-key-here",
    "Content-Type": "application/json"
}
data = {
    "urls": [
        "https://www.tiktok.com/@user/video/1234567890",
        "https://www.instagram.com/p/ABC123/"
    ]
}

response = requests.post(url, json=data, headers=headers)
result = response.json()

if result["code"] == 0:
    print(f"Successfully created {result['data']['success']} feeds")
    for feed in result["data"]["results"]:
        print(f"  - {feed['url']}: {feed['feedId']}")
else:
    print(f"Error: {result['message']}")

Exemple JavaScript - Actualiser des flux

const response = await fetch('https://snstracker.com/api/v1/feeds/refresh', {
  method: 'POST',
  headers: {
    'X-API-Key': 'your-api-key-here',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    feedIds: ['feed_abc123xyz', 'feed_def456uvw'],
  }),
});

const result = await response.json();

if (result.code === 0) {
  console.log(`Successfully refreshed ${result.data.total} feeds`);
  result.data.feedIds.forEach((feedId) => {
    console.log(`  - ${feedId}`);
  });
} else {
  console.error(`Error: ${result.message}`);
}

Notes importantes

  1. Validation des URL : Toutes les URL sont automatiquement validées avant la création. Les URL invalides seront rejetées.

  2. Éléments en double : Si un élément avec la même URL existe déjà dans la collection :

    • S’il est actif, il sera ignoré (marqué avec skipped: true)
    • S’il est arrêté, il sera repris (marqué avec resumed: true)

  3. Collecte des données : Après une création réussie, les éléments sont mis en file d’attente pour la collecte des données. Les données seront disponibles peu après la création.

  4. Statut d’actualisation : Seuls les éléments avec le statut "Pending" ou "Tracked" peuvent être actualisés. Les éléments avec d’autres statuts seront filtrés.

  5. Crédits : Assurez-vous d’avoir suffisamment de crédits avant d’effectuer des requêtes. Les opérations de synchronisation consomment des crédits immédiatement après la récupération réussie des données. Xiaohongshu channel tasks are priced separately and currently cost 10 credits per successful request. /api/v1/channels/feeds/sync: Chaque page récupérée avec succès coûte 10 crédits, y compris les pages vides. Seules les requêtes échouées sont gratuites ; un solde initial de 10 crédits est requis. La limite simultanée de l’équipe est partagée avec les autres API de synchronisation. Aucun enregistrement de tableau de bord n’est créé. /api/v1/channels/about/sync: Chaque requête réussie coûte 80 crédits, même si les champs sont null. Les erreurs ne sont pas facturées ; solde minimal de 80 crédits avant la requête. Concurrence partagée avec toutes les API synchrones de l’équipe : Starter/sans abonnement actif 1, Standard 5, Premium 10. Aucun enregistrement ni webhook créé.

  6. Synchronisations simultanées par équipe (/api/v1/feeds/sync + /api/v1/channels/sync + /api/v1/channels/feeds/sync + /api/v1/channels/about/sync): Tous les membres et clés API d’une équipe partagent une seule limite pour tous les endpoints de synchronisation. La limite partagée est de 1 pour Starter ou sans abonnement valide, 5 pour Standard et 10 pour Premium. La limite suit l’abonnement actuellement en vigueur ; un réglage spécifique à l’équipe défini par le support officiel est prioritaire. Pour augmenter la limite de votre équipe, contactez le support officiel.

  7. Synchronisation vs création : Les points de terminaison de synchronisation (/api/v1/feeds/sync et /api/v1/channels/sync + /api/v1/channels/feeds/sync + /api/v1/channels/about/sync) sont autonomes et ne s’intègrent PAS à la plateforme web. Ils ne renvoient que les données dans la réponse API et ne créent pas d’enregistrements dans le tableau de bord. Pour créer des éléments de surveillance persistants qui apparaissent dans la plateforme web, utilisez plutôt les points de terminaison de création (/api/v1/feeds et /api/v1/channels).

  8. Nouvelle tentative : Après un 429, attendez la fin d’une requête active puis réessayez avec des délais croissants en respectant Retry-After. Après un 503, réessayez plus tard.

  9. Plateformes prises en charge : TikTok, Instagram, YouTube et d’autres grandes plateformes de réseaux sociaux.

Dépannage

Problème : "X-API-Key header is required"
Solution : Assurez-vous d’inclure l’en-tête X-API-Key dans votre requête.

Problème : "Invalid API key"
Solution : Vérifiez que votre clé API est correcte. Vous pouvez en créer une nouvelle dans Paramètres → Clés API.

Problème : "Maximum URLs allowed per request"
Solution : Répartissez vos URL sur plusieurs requêtes. Les flux acceptent jusqu’à 200 URL, les canaux jusqu’à 5 URL par requête.

Problème : "No collection found"
Solution : Créez d’abord une collection dans le tableau de bord, ou spécifiez un ID de collection existant.

Problème : "Insufficient credits"
Solution : Achetez plus de crédits ou vérifiez votre plan d’abonnement.

Problème : "No refreshable items found"
Solution : Seuls les éléments avec le statut "Pending" ou "Tracked" peuvent être actualisés. Vérifiez le statut de vos éléments.

Problème : Certaines URL échouent à la validation
Solution : Vérifiez le tableau errors dans la réponse pour des messages d’erreur spécifiques. Assurez-vous que les URL proviennent de plateformes prises en charge et sont accessibles publiquement.

Guide de configuration du webhook

Next Page

On this page

Aperçu
Authentification
Points de terminaison de l’API
1. Créer des flux
Requête
Réponse
Exemple de requête
2. Actualiser des flux
Requête
Réponse
Exemple de requête
3. Créer des canaux
Requête
Réponse
Exemple de requête
4. Actualiser des canaux
Requête
Réponse
Exemple de requête
5. Synchroniser un flux
Requête
Réponse
Exemple de requête
6. Synchroniser un canal
Requête
Réponse
Exemple de requête
7. Synchroniser les publications d’un canal
Request and pagination
Response example (placeholder cursor) — reels, lunacut.edit, count=1
8. Obtenir les informations supplémentaires du profil
Intégration des webhooks
Configuration des webhooks
Réponses d’erreur
401 Unauthorized - Clé API manquante
401 Unauthorized - Clé API invalide
400 Bad Request - Entrée invalide
400 Bad Request - Trop d’URL (Créer des flux)
400 Bad Request - Trop d’URL (Créer des canaux)
400 Bad Request - Crédits insuffisants
429 Too Many Requests - Synchronisations simultanées par équipe
403 Forbidden - Collection invalide
404 Not Found
Exemples d’utilisation
Exemple Python - Créer des flux
Exemple JavaScript - Actualiser des flux
Notes importantes
Dépannage