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

Google Dataset Search Advanced en direct

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

Google Dataset Search Advanced en direct

​

Renvoie les jeux de données qui correspondent à une requête dans Google Dataset Search, 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.02.
  • 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)[]
    • depth
      Type: integer | null

      profondeur d'analyse

      champ facultatif

      nombre de résultats dans la SERP

      valeur par défaut : 20

      valeur maximale : 200


      Votre compte sera facturé pour chaque SERP contenant jusqu'à 20 résultats ;

      définir une profondeur supérieure à 20 peut entraîner des frais supplémentaires si le moteur de recherche renvoie plus de 20 résultats ;

      si la profondeur 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

      renvoie les résultats pour un type d'appareil spécifique

      valeur possible : desktop

    • file_formats
      Type: array string[] | null

      formats de fichier du jeu de données

      champ facultatif

      valeurs possibles : other, archive, text, image, document, tabular

    • is_free
      Type: boolean | null

      indique si les jeux de données affichés sont gratuits

      champ facultatif

      valeurs possibles : true, false

    • 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é comme un 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 facultatif si vous ne spécifiez pas language_name

      si vous utilisez ce champ, vous n'avez pas besoin de spécifier language_name

      valeur possible :

      en

    • language_name
      Type: string | null

      nom complet de la langue du moteur de recherche

      champ facultatif

      si vous utilisez ce champ, vous n'avez pas besoin de spécifier language_code

      valeur possible :

      English

    • last_updated
      Type: string | null

      dernière mise à jour du jeu de données

      champ facultatif

      valeurs possibles : 1m, 1y, 3y

    • os
      Type: string | null

      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

    • topics
      Type: array string[] | null

      thèmes du jeu de données

      champ facultatif

      valeurs possibles : humanities, social_sciences, life_sciences, agriculture, natural_sciences, geo, computer, architecture_and_urban_planning, engineering

    • usage_rights
      Type: string | null

      droits d'utilisation du jeu de données

      champ facultatif

      valeurs possibles : commercial, noncommercial

Réponses
  • 200
    Type: object | null · Response36Afe1097B20_SerpGoogleDatasetSearchLiveAdvancedResponseInfo
    • 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_SerpGoogleDatasetSearchLiveAdvancedTaskInfo
        • 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 fournissons 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.
            type d'élément possible : dataset

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

            éléments de l'élément

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

              la liste des zones couvertes dans le jeu de données
              par exemple : Africa, Global

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

              la liste des auteurs du jeu de données

              • domain
                Type: string | null

                domaine du lien de l'auteur

              • name
                Type: string | null

                nom de l'auteur du jeu de données

              • type
                Type: string | null

                type d'élément

              • url
                Type: string | null

                URL du lien de l'auteur

            • dataset_description
              Type: object | null · Response36Afe1097B20_DatasetDescription

              description du jeu de données

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

                liens présentés dans 'dataset_description'

                • description
                  Type: string | null

                  description de l'élément de résultats

                • domain
                  Type: string | null

                  domaine vers lequel un lien pointe

                • snippet
                  Type: string | null

                  texte à côté du titre du lien

                • title
                  Type: string | null

                  titre d'un élément de lien donné

                • type
                  Type: string | null

                  type d'élément

                • url
                  Type: string | null

                  URL

                • xpath
                  Type: string | null

                  le XPath de l'élément

              • text
                Type: string | null

                texte de la description

            • dataset_id
              Type: string | null

              ID du jeu de données

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

              la liste des institutions ayant fourni le jeu de données

              • domain
                Type: string | null

                domaine dans la SERP

              • title
                Type: string | null

                titre de l'élément

              • type
                Type: string | null

                type d'élément

              • url
                Type: string | null

                URL de recherche avec paramètres d'affinage

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

              la liste des formats de fichier du jeu de données

              • format
                Type: string | null

                type de format de fichier du jeu de données
                par exemple : zip, html, csv

              • size
                Type: integer | null Format: int64

                taille du fichier en octets

              • type
                Type: string | null

                type d'élément

            • image_url
              Type: string | null

              URL de l'image
              l'URL menant à l'image sur la ressource d'origine ou dans le stockage DataForSEO (si la source d'origine n'est pas disponible)

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

              la liste des licences délivrées pour le jeu de données

              • domain
                Type: string | null

                domaine dans la SERP

              • title
                Type: string | null

                titre de l'élément

              • type
                Type: string | null

                type d'élément

              • url
                Type: string | null

                URL de recherche avec paramètres d'affinage

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

              sitelinks
              les liens affichés sous certains résultats de recherche de Google Dataset
              s'il n'y en a aucun, la valeur est null

              • description
                Type: string | null

                description de l'élément de résultats

              • domain
                Type: string | null

                domaine vers lequel un lien pointe

              • snippet
                Type: string | null

                texte à côté du titre du lien

              • title
                Type: string | null

                titre d'un élément de lien donné

              • type
                Type: string | null

                type d'élément

              • url
                Type: string | null

                URL

              • xpath
                Type: string | null

                le XPath de l'élément

            • period_covered
              Type: object | null · Response36Afe1097B20_PeriodCovered

              période couverte dans le jeu de données

              • displayed_date
                Type: string | null

                période affichée dans le SERP
                exemple :
                Mar 2, 2020 - Dec 9, 2022

              • end_date
                Type: string | null

                date et heure de fin de la période
                au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
                exemple :
                2022-12-09 02:00:00 +00:00

              • start_date
                Type: string | null

                date et heure de début de la période
                au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
                exemple :
                2020-03-02 02:00:00 +00:00

            • position
              Type: string | null

              l'alignement de l'élément dans la SERP
              peut prendre les valeurs suivantes :
              left, right

            • rank_absolute
              Type: integer | null

              rang absolu dans les SERP
              position absolue parmi tous les éléments du SERP

            • rank_group
              Type: integer | null

              rang de groupe dans les 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

            • related_article
              Type: string | null

              lien vers l'article associé
              lien vers l'article publié associé au jeu de données

            • scholarly_articles_url
              Type: string | null

              URL des articles scientifiques
              lien vers la liste des articles scientifiques sur Google Scholar
              exemple : https://scholar.google.com/scholar?q=%2210.6084%20m9%20figshare%207427933%20v1%22

            • scholarly_citations_count
              Type: integer | null Format: int64

              nombre d'articles qui font référence au jeu de données

            • title
              Type: string | null

              titre de l'élément

            • type
              Type: string | null

              type d'élément

            • unique_identifier
              Type: string | null

              identifiant numérique d'un objet
              identifiant numérique unique du jeu de données
              exemple : https://doi.org/10.5061/dryad.hmgqnk9m3

            • updated_date
              Type: string | null

              date et heure de la dernière mise à jour du résultat
              au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
              exemple :
              2022-11-27 02:00:00 +00:00

            • xpath
              Type: string | null

              le XPath de l'élément

          • 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

          • 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 indiquerons le mot-clé corrigé par le moteur de recherche et 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
Request Example for post/v1/beta/dataforseo/serp/google/dataset_search/live/advanced
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/dataset_search/live/advanced \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keyword": "water quality",
    "last_updated": "1m",
    "file_formats": [
      "archive",
      "image"
    ],
    "usage_rights": "noncommercial",
    "is_free": true,
    "topics": [
      "natural_sciences",
      "geo"
    ]
  }
]'

{
  "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,
          "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,
              "position": null,
              "xpath": null,
              "dataset_id": null,
              "title": null,
              "image_url": null,
              "scholarly_citations_count": null,
              "scholarly_articles_url": null,
              "unique_identifier": null,
              "related_article": null,
              "links": [
                "[Max Depth Exceeded]"
              ],
              "dataset_providers": [
                "[Max Depth Exceeded]"
              ],
              "formats": [
                "[Max Depth Exceeded]"
              ],
              "authors": [
                "[Max Depth Exceeded]"
              ],
              "licenses": [
                "[Max Depth Exceeded]"
              ],
              "updated_date": null,
              "area_covered": [
                "[Max Depth Exceeded]"
              ],
              "period_covered": "[Max Depth Exceeded]",
              "dataset_description": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Opération réussie

Live Google Dataset Search Advanced