Aller au contenu
NouveautésNouveau

Social : lisez YouTube, Instagram et Threads via l’API

Social
Une requête SOCIAL sur POST /v1/async/task pour la recherche YouTube wireless earbuds review, et la première vidéo de la réponse avec sa chaîne, 62 618 vues et 957 j’aime

Recherchez sur YouTube, Instagram et Threads et recevez vidéos, publications, commentaires, profils et sous-titres YouTube en JSON depuis n’importe quelle clé API, pour 0,5 crédit par requête terminée.

Ce que vous obtenez

  • platform youtube : résultats de recherche, dernières mises en ligne pour une recherche, page d’une vidéo, commentaires et leurs réponses, une chaîne, les vidéos, Shorts ou directs d’une chaîne, et sous-titres.
  • platform instagram : publications et reels pour un mot-clé, un profil public avec ses 12 publications les plus récentes, une publication ou un reel, et ses commentaires.
  • platform threads : publications pour un mot-clé, un profil public avec ses publications récentes, une publication et ses réponses.
  • Les compteurs arrivent en nombres, comme viewCount, likeCount, commentCount et followerCount, avec l’heure publishedAt, pour comparer les publications sans analyser un texte comme 62K.

Fonctionnement

Envoyez taskType SOCIAL à POST /v1/async/task avec une platform et une action. search, l’action par défaut, prend query. Les autres actions prennent videoId, channel, username ou postUrl, et vous pouvez y coller l’URL de la page.

Social lit les pages publiques. Sur Instagram, ce sont les 12 publications les plus récentes d’un profil et une douzaine de commentaires par publication, et sur Threads une dizaine de réponses par publication. Une page qui n’existe pas ou qui demande une connexion termine la tâche avec PAGE_UNAVAILABLE.

Une recherche de vidéos YouTube triée par relevance renvoie nextPageToken pour la page suivante. transcript renvoie le text des sous-titres et des segments horodatés dans les langues demandées, et translateTo demande à YouTube de les traduire. L’outil read_social du serveur MCP de querying.ai lance les mêmes lectures depuis Claude Code, Codex, Cursor et d’autres clients MCP.

Cas d’usage

  • Suivez jour après jour les vues, les j’aime et les commentaires des vidéos de votre marque et de vos concurrents.
  • Lisez les commentaires et les réponses sous un lancement sur YouTube, Instagram et Threads, et relevez les questions posées.
  • Donnez à votre modèle la transcription horodatée d’une vidéo de test et trouvez où elle cite votre produit.
  • Mettez ce que disent les créateurs sur YouTube et Threads à côté des réponses de ChatGPT et de Google AI Mode pour la même recherche.

Envoyer la requête

Envoyez la requête avec votre clé API dans l’en-tête Authorization.

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "SOCIAL",
    "payload": {
      "platform": "youtube",
      "action": "search",
      "query": "wireless earbuds review",
      "limit": 10
    }
  }'

Champs de la requête

taskTypestringObligatoire
Le moteur à interroger, par exemple CHATGPT ou GOOGLE.
payload.platformstringObligatoire
La plateforme à lire : youtube, instagram ou threads.
payload.actionstring
Ce qu’on lit, par exemple search, video, comments ou transcript. search par défaut. Chaque plateforme liste ses actions dans la documentation.
payload.querystring
La recherche pour search et recent, rédigée comme un utilisateur la tape dans le champ de recherche de la plateforme.
payload.limitinteger
Nombre de résultats renvoyés. Une recherche YouTube accepte de 1 à 50, 10 par défaut.
webhook.urlstring
Une adresse HTTPS de votre serveur. La tâche terminée y est envoyée dès qu’elle se termine.

Réponse

Voici une tâche terminée, raccourcie pour la lecture.

JSON
{
  "success": true,
  "task": {
    "id": "…",
    "taskType": "SOCIAL",
    "status": "COMPLETED",
    "createdAt": "…"
  },
  "credits": { "creditsToCharge": 0.5, "creditsCharged": 0.5 },
  "response": {
    "platform": "youtube",
    "action": "search",
    "query": "wireless earbuds review",
    "order": "relevance",
    "returnedCount": 10,
    "videos": [
      {
        "position": 1,
        "videoId": "YdJh6QdOGME",
        "url": "https://www.youtube.com/watch?v=YdJh6QdOGME",
        "title": "Earbuds Awards 2026 - Best Bluetooth Earbuds by Category!",
        "channelTitle": "Mike O'Brien",
        "channelHandle": "@MikeOBrienMedia",
        "publishedAt": "2026-11-17T15:39:37Z",
        "durationSeconds": 995,
        "viewCount": 62618,
        "likeCount": 957
      },
      "…"
    ],
    "nextPageToken": "eyJyIjpbIllkSmg2UWRPR01FIl19"
  }
}
task.statusstring
QUEUED, PROCESSING, puis COMPLETED avec la réponse ou FAILED avec error.
credits.creditsChargedinteger
Crédits facturés pour la tâche terminée. Une tâche en échec facture 0.
response.returnedCountinteger
Le nombre de produits dans products.
response.videosarray
Les vidéos dans l’ordre de YouTube : position, videoId, url, title, la chaîne, publishedAt, durationSeconds, viewCount et likeCount.

Recevoir le résultat

La requête renvoie aussitôt la tâche avec status QUEUED. Interrogez GET /v1/async/task/{id} jusqu’à ce que status vaille COMPLETED ou FAILED, ou ajoutez webhook.url pour recevoir la tâche terminée sur votre serveur, avec les mêmes task, credits et response. Les résultats restent disponibles 24 heures après la fin de la tâche.

curl https://api.querying.ai/v1/async/task/$TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

Tarif

Chaque requête terminée coûte 0,5 crédit, sur toutes les plateformes et pour toutes les actions. Seules les requêtes terminées sont facturées. Offres et crédits : https://querying.ai/pricing

Autres nouveautés

Recevez les nouveautés

Recevez les mises à jour par e-mail.

Flux RSS