v0.2.0-beta

OpenAPI 3.1.0

YouTube Organic 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

post/v1/beta/dataforseo/serp/youtube/organic/live/advanced

YouTube Organic Advanced en temps réel

Renvoie les résultats classés d'un mot-clé sur YouTube, de façon synchrone. 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.002.
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)[]
- block_depth
  Type: integer | null
  
  profondeur d'analyse champ facultatif nombre de blocs de résultats dans le SERP valeur par défaut : 20 valeur maximale : 200 Remarque : votre compte sera facturé pour chaque SERP contenant jusqu'à 20 résultats ; par conséquent, définir une profondeur de blocs supérieure à 20 peut entraîner des frais supplémentaires si le moteur de recherche renvoie plus de 20 résultats ; si la profondeur de blocs indiquée est supérieure au nombre de résultats de la réponse, la différence sera automatiquement remboursée sur le solde de votre compte
- device
  Type: string | null
  
  type d'appareil champ facultatif renvoyer les résultats pour un type d'appareil particulier valeurs disponibles : desktop, mobile
- keyword
  Type: string
  
  mot-clé champ obligatoire vous pouvez indiquer jusqu'à 700 caractères dans le champ keyword tous les %## seront décodés (le caractère ‘+’ sera décodé en espace) si vous devez utiliser le caractère “%” dans votre keyword, indiquez-le comme “%25” ; si vous devez utiliser le caractère “+” dans votre keyword, indiquez-le comme “%2B” ; en savoir plus sur les règles et limites des champs keyword et keywords dans les API DataForSEO dans cet article du centre d'aide
- 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 si vous indiquez desktop dans le champ device, choisissez parmi les valeurs suivantes : windows, macos valeur par défaut : windows si vous indiquez mobile dans le champ device, choisissez parmi les valeurs suivantes : android, ios valeur par défaut : android
- search_param
  Type: string | null
  
  paramètres supplémentaires de la requête de recherche champ facultatif exemple : sp=EgIQAg%253D%253D
- 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

Réponses

200
Type: object | null · Response36Afe1097B20_SerpYoutubeOrganicLiveAdvancedResponseInfo
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_SerpYoutubeOrganicLiveAdvancedTaskInfo
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. types d'éléments possibles : youtube_channel, youtube_video, youtube_video_paid, youtube_playlist

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

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

block_name
Type: string | null

nom du bloc dans la SERP
exemple :
"People also watched"

block_rank
Type: integer | null

rang du bloc dans la SERP
position parmi tous les blocs de la SERP

channel_id
Type: string | null

ID de la chaîne

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

type
Type: string | null

type d'élément

url
Type: string | null

URL de la chaîne

items_count
Type: integer | null Format: int64

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

keyword
Type: string | null

mot-clé reçu dans un tableau POST le mot-clé est renvoyé avec %## décodé (le caractère '+' sera décodé en espace)

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

se_results_count
Type: integer | null Format: int64

nombre total de résultats dans la SERP

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

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

post/v1/beta/dataforseo/serp/youtube/organic/live/advanced

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/youtube/organic/live/advanced \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "audi"
  }
]'

Afficher le schéma

{
  "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": [
        {
          "keyword": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "spell": {
            "keyword": null,
            "type": null
          },
          "item_types": [
            null
          ],
          "se_results_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "block_rank": null,
              "block_name": null,
              "channel_id": null,
              "url": null
            }
          ]
        }
      ]
    }
  ]
}

Opération réussie

YouTube Organic Advanced en temps réel

AuthentificationRequired

DataForSEO

YouTube Organic Advanced en temps réel

Référence tarifaire