v0.2.0-beta

OpenAPI 3.1.0

Obtenir les résultats avancés de Google Autocomplete par id

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

get/v1/beta/dataforseo/serp/google/autocomplete/task_get/advanced/{id}

Obtenir les résultats avancés de Google Autocomplete par id

Récupère un résultat Google Autocomplete en file d'attente par id. Renvoie keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count et items. 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.

Paramètres de chemin

id
Type: string
obligatoire

identifiant de la tâche
identifiant unique de la tâche dans notre système au format UUID
vous pourrez l'utiliser pendant 30 jours pour demander les résultats de la tâche à tout moment

Réponses

200
Type: object | null · Response36Afe1097B20_SerpGoogleAutocompleteTaskGetAdvancedResponseInfo
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_SerpGoogleAutocompleteTaskGetAdvancedTaskInfo
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.
types d'éléments possibles :
autocomplete

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

éléments de l'élément

highlighted
Type: array (string | null)[] | null

mots-clés mis en évidence dans l'autocomplétion
contient une liste de suggestions d'autocomplétion Google mises en évidence dans la barre de recherche ;
Remarque : le tableau n'est disponible que pour le client suivant :
gws-wiz
psy-ab
gws-wiz-local

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

relevance
Type: integer | null

pertinence du mot-clé suggéré
représente la pertinence de la suggestion d'autocomplétion par rapport au mot-clé cible
peut prendre des valeurs de 500 à 2000
plus la valeur est élevée, plus la suggestion est pertinente
Remarque : disponible uniquement pour le client suivant :
chrome/chrome-omni

search_query_url
Type: string | null

URL des résultats de recherche
URL des résultats de recherche pertinents pour la suggestion d'autocomplétion Google

suggestion
Type: string | null

suggestion de mot-clé d'autocomplétion Google

suggestion_type
Type: string | null

type de suggestion d'autocomplétion Google
Remarque : disponible uniquement pour le client suivant :
chrome/chrome-omni

thumbnail_url
Type: string | null

URL de l'image miniature
URL de l'image miniature de la suggestion d'autocomplétion Google
Remarque : disponible uniquement pour le client suivant :
gws-wiz
gws-wiz-serp

type
Type: string | null

type d'é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 symbole plus '+' 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

refinement_chips
Type: object | null · Response36Afe1097B20_RefinementChipsInfo

puces de raffinement de recherche

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

items de l'élément

domain
Type: string | null

domaine dans la SERP

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

autres options d'affinage de la recherche

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

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

type
Type: string | null

type d'élément

xpath
Type: string | null

le XPath de l'élément

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 ;
dans ce cas, sera égal à null

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

type
Type: string | null

type d'élément

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

get/v1/beta/dataforseo/serp/google/autocomplete/task_get/advanced/{id}

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/autocomplete/task_get/advanced/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

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,
          "type": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "spell": {
            "keyword": null,
            "type": null
          },
          "refinement_chips": {
            "type": null,
            "xpath": null,
            "items": [
              "[Max Depth Exceeded]"
            ]
          },
          "item_types": [
            null
          ],
          "se_results_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "relevance": null,
              "suggestion": null,
              "suggestion_type": null,
              "search_query_url": null,
              "thumbnail_url": null,
              "highlighted": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

Opération réussie

Obtenir les résultats avancés de Google Autocomplete par id

AuthentificationRequired

DataForSEO

Obtenir les résultats avancés de Google Autocomplete par id

Référence tarifaire