Felo API PlatformFelo API Platform
Tous les endpoints DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

YouTube Video Info Advanced en temps réel

Felo API Support
MIT
Serveur:https://openapi.felo.ai
Bibliothèques clientes
Shell Curl

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Opérations

YouTube Video Info Advanced en temps réel

​

Renvoie de façon synchrone les métadonnées d'une vidéo YouTube sur YouTube. Renvoie keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count et items. advanced est le choix par défaut ; prenez regular quand seule la liste classée importe, et html uniquement pour vérifier ce que l'analyseur a écarté. Enveloppé dans l'enveloppe DataForSEO : les données dans tasks[0].result, l'issue dans tasks[0].status_code — une requête rejetée renvoie tout de même HTTP 200.

Référence tarifaire

  • Mesure : coût de réponse déclaré.
  • Estimation de référence par requête : USD 0.006.
  • Multiplicateur client de référence : 1.0. Ne pas l'appliquer à nouveau à un montant client déjà réglé.

Métadonnées de référence uniquement, et non un devis de compte, un prix garanti ou un plafond de dépenses. Les crédits de ressources ne sont pas des crédits Felo. Les débits définitifs suivent les enregistrements de facturation Felo.

Corps
application/json
  • Type: array (object | null)[]
    • device
      Type: string | null

      type d'appareil champ facultatif valeur unique : desktop

    • language_code
      Type: string | null

      code de langue du moteur de recherche champ obligatoire si vous ne spécifiez pas language_name si vous utilisez ce champ, vous n'avez pas besoin de spécifier language_name vous pouvez obtenir la liste des langues disponibles du moteur de recherche avec leur language_code en effectuant une requête distincte sur https://api.dataforseo.com/v3/serp/youtube/languages exemple : en

    • language_name
      Type: string | null

      nom complet de la langue du moteur de recherche champ obligatoire si vous ne spécifiez pas language_code si vous utilisez ce champ, vous n'avez pas besoin de spécifier language_code vous pouvez obtenir la liste des langues disponibles du moteur de recherche avec leur language_name en effectuant une requête distincte sur https://api.dataforseo.com/v3/serp/youtube/languages exemple : English

    • location_code
      Type: integer | null

      code d'emplacement du moteur de recherche champ obligatoire si vous ne spécifiez pas location_name si vous utilisez ce champ, vous n'avez pas besoin de spécifier location_name vous pouvez obtenir la liste des emplacements disponibles des moteurs de recherche avec leur location_code en effectuant une requête distincte sur https://api.dataforseo.com/v3/serp/youtube/locations exemple : 2840

    • location_name
      Type: string | null

      nom complet de l'emplacement du moteur de recherche champ obligatoire si vous ne spécifiez pas location_code si vous utilisez ce champ, vous n'avez pas besoin de spécifier location_code vous pouvez obtenir la liste des emplacements disponibles du moteur de recherche avec leur location_name en effectuant une requête distincte sur https://api.dataforseo.com/v3/serp/youtube/locations exemple : United States

    • os
      Type: string | null

      type de système d'exploitation de l'appareil champ facultatif choisissez parmi les valeurs suivantes : windows, macos valeur par défaut : windows

    • tag
      Type: string | null

      identifiant de tâche défini par l'utilisateur champ facultatif la limite est de 255 caractères vous pouvez utiliser ce paramètre pour identifier la tâche et l'associer au résultat vous trouverez la valeur tag indiquée dans l'objet data de la réponse

    • video_id
      Type: string

      ID de la vidéo champ obligatoire vous pouvez trouver l'ID de la vidéo dans l'URL ou dans l'élément 'youtube_video' du résultat YouTube Organic exemple : vQXvyV0zIP4

Réponses
  • 200
    Type: object | null · Response36Afe1097B20_SerpYoutubeVideoInfoLiveAdvancedResponseInfo
    • cost
      Type: number | null Format: double

      coût total des tâches, USD

    • status_code
      Type: integer | null

      code d'état général vous pouvez trouver la liste complète des codes de réponse ici

    • status_message
      Type: string | null

      message d'information général vous pouvez trouver la liste complète des messages d'information généraux ici

    • tasks
      Type: array (object | null)[] | null

      tableau de tâches

      • Type: object | null · Response36Afe1097B20_SerpYoutubeVideoInfoLiveAdvancedTaskInfo
        • cost
          Type: number | null Format: double

          coût total des tâches, USD

        • data
          Type: object | null

          contient les mêmes paramètres que ceux spécifiés dans la requête POST

          • propertyName
            Type: object | null
        • id
          Type: string | null

          identifiant de la tâche identifiant unique de la tâche dans notre système au format UUID

        • path
          Type: array (string | null)[] | null

          chemin de l'URL

        • result
          Type: array (object | null)[] | null

          tableau de résultats

          • check_url
            Type: string | null

            URL directe vers les résultats du moteur de recherche vous pouvez l'utiliser pour vérifier que nous avons fourni des résultats précis

          • datetime
            Type: string | null

            date et heure de réception du résultat au format UTC : “yyyy-mm-dd hh-mm-ss +00:00” exemple : 2019-11-15 12:57:46 +00:00

          • item_types
            Type: array (string | null)[] | null

            types de résultats de recherche dans la SERP contient les types de résultats de recherche (items) trouvés dans la SERP. élément possible : youtube_video_info

          • items
            Type: array (object | null)[] | null

            éléments de résultats de recherche trouvés dans la SERP

            • category
              Type: string | null

              la catégorie à laquelle appartient la vidéo

            • channel_id
              Type: string | null

              l'ID de la chaîne où la vidéo est publiée

            • channel_logo
              Type: string | null

              l'URL de la page où l'image du logo de la chaîne est hébergée

            • channel_name
              Type: string | null

              le nom de la chaîne où la vidéo est publiée

            • channel_subscribers_count
              Type: object | null · Response36Afe1097B20_ChannelSubscribersCount

              nombre d'abonnés de la chaîne

              • count
                Type: integer | null Format: int64

                nombre d'abonnés

              • displayed_count
                Type: string | null

                nombre d'abonnés affiché
                nombre d'abonnés tel qu'affiché sur YouTube

            • channel_url
              Type: string | null

              l'URL de la chaîne où la vidéo est publiée

            • comments_count
              Type: integer | null Format: int64

              nombre de commentaires sur la vidéo

            • description
              Type: string | null

              description de la vidéo

            • duration_time
              Type: string | null

              durée de la vidéo

            • duration_time_seconds
              Type: integer | null

              durée de la vidéo en secondes

            • is_embeddable
              Type: boolean | null

              indique si la vidéo peut être intégrée

            • is_live
              Type: boolean | null

              indique si la vidéo est en direct

            • keywords
              Type: array (string | null)[] | null

              mots-clés pertinents pour la vidéo
              également appelés 'YouTube tags'

            • likes_count
              Type: integer | null Format: int64

              nombre de mentions J'aime sur la vidéo

            • publication_date
              Type: string | null

              la date de publication de la vidéo

            • rank_absolute
              Type: integer | null

              rang absolu dans la SERP pour le domaine cible
              position absolue parmi tous les éléments de la SERP

            • rank_group
              Type: integer | null

              rang du groupe dans la SERP
              position au sein d'un groupe d'éléments ayant des valeurs type identiques
              les positions des éléments ayant des valeurs type différentes sont omises de rank_group

            • streaming_quality
              Type: array (object | null)[] | null

              tableau d'éléments contenant des informations sur toutes les qualités de streaming possibles de la vidéo

              • bitrate
                Type: integer | null

                débit binaire de la vidéo

              • fps
                Type: integer | null

                fréquence d'images de la vidéo

              • height
                Type: integer | null

                hauteur de la vidéo en pixels

              • label
                Type: string | null

                libellé de l'élément de qualité

              • mime_type
                Type: string | null

                type de média de la vidéo

              • type
                Type: string | null

                type d'élément

              • width
                Type: integer | null Format: int64

                largeur de la vidéo en pixels

            • subtitles
              Type: array (object | null)[] | null

              tableau d'éléments décrivant les propriétés des sous-titres de la vidéo

              • is_auto_generated
                Type: boolean | null

                indique si les sous-titres sont générés automatiquement

              • is_translatable
                Type: boolean | null

                indique si les sous-titres sont traduisibles

              • language
                Type: string | null

                langue des sous-titres

            • thumbnail_url
              Type: string | null

              l'URL de la page où la miniature est hébergée

            • timestamp
              Type: string | null

              date et heure de publication du résultat
              au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
              exemple :
              2022-11-15 12:57:46 +00:00

            • title
              Type: string | null

              titre de la vidéo

            • type
              Type: string | null

              type d'élément

            • url
              Type: string | null

              URL de la vidéo

            • video_id
              Type: string | null

              ID de la vidéo reçue dans un tableau POST

            • views_count
              Type: integer | null Format: int64

              nombre de vues de la vidéo

          • items_count
            Type: integer | null Format: int64

            le nombre de résultats renvoyés dans le tableau items

          • language_code
            Type: string | null

            code de langue dans un tableau POST

          • location_code
            Type: integer | null

            code de localisation dans un tableau POST

          • se_domain
            Type: string | null

            domaine du moteur de recherche dans un tableau POST

          • spell
            Type: object | null · Response36Afe1097B20_SpellInfo

            autocorrection du moteur de recherche si le moteur de recherche a fourni des résultats pour un mot-clé corrigé, nous précisons le mot-clé corrigé par le moteur de recherche ainsi que le type d'autocorrection

            • keyword
              Type: string | null

              mot-clé obtenu à la suite de l'autocorrection du moteur de recherche les résultats seront fournis pour le mot-clé corrigé

            • type
              Type: string | null

              type d'autocorrection valeurs possibles : did_you_mean, showing_results_for, no_results_found_for, including_results_for remarque : Yahoo et Yandex ne prennent en charge que le type d'autocorrection suivant : including_results_for

          • video_id
            Type: string | null

            ID de la vidéo reçue dans un tableau POST

        • result_count
          Type: integer | null Format: int64

          nombre d'éléments dans le tableau de résultats

        • status_code
          Type: integer | null

          code d'état de la tâche généré par DataForSEO ; peut être compris dans la plage suivante : 10000-60000 vous pouvez trouver la liste complète des codes de réponse ici

        • status_message
          Type: string | null

          message d'information de la tâche vous pouvez trouver la liste complète des messages d'information généraux ici

        • time
          Type: string | null

          temps d'exécution, en secondes

    • tasks_count
      Type: integer | null Format: int64

      le nombre de tâches dans le tableau de tâches

    • tasks_error
      Type: integer | null Format: int64

      le nombre de tâches dans le tableau de tâches renvoyées avec une erreur

    • time
      Type: string | null

      temps d'exécution total, en secondes

    • version
      Type: string | null

      la version actuelle de l'API

    application/json
  • 400

    La requête n'a pas pu être traitée. Vérifiez les paramètres de la requête.

  • 401

    Une clé API Felo valide est requise.

  • 402

    La requête ne peut pas aboutir car une condition de facturation n'est pas remplie.

  • 403

    Le compte n'est pas autorisé à effectuer cette opération.

  • 429

    Une limite de requêtes ou de dépenses a été atteinte.

  • 502

    Le service n'a pas pu terminer la requête.

  • 503

    L'API ou le service de facturation est temporairement indisponible.

  • 504

    Le service a expiré lors du traitement de la requête.

  • default

    Réponse d'erreur ; les réponses transmises depuis l'upstream peuvent utiliser les formats du fournisseur

    application/json
Request Example for post/v1/beta/dataforseo/serp/youtube/video_info/live/advanced
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/youtube/video_info/live/advanced \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "video_id": "vQXvyV0zIP4"
  }
]'

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": [
        {
          "video_id": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "spell": {
            "keyword": null,
            "type": null
          },
          "item_types": [
            null
          ],
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "video_id": null,
              "title": null,
              "url": null,
              "thumbnail_url": null,
              "channel_id": null,
              "channel_name": null,
              "channel_url": null,
              "channel_logo": null,
              "description": null,
              "views_count": null,
              "likes_count": null,
              "comments_count": null,
              "channel_subscribers_count": "[Max Depth Exceeded]",
              "publication_date": null,
              "timestamp": null,
              "keywords": [
                "[Max Depth Exceeded]"
              ],
              "category": null,
              "is_live": null,
              "is_embeddable": null,
              "duration_time": null,
              "duration_time_seconds": null,
              "subtitles": [
                "[Max Depth Exceeded]"
              ],
              "streaming_quality": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

Opération réussie

Live YouTube Video Info Advanced