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

Concurrents SERP

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

Concurrents SERP

​

Les domaines qui se classent à vos côtés pour un ensemble de keywords, avec le nombre de mots-clés partagés. Renvoie se_type, seed_keywords, total_count, 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. ⚠️ Il s'agit de concurrents de recherche, déterminés par des classements partagés. L'équivalent dans le graphe de liens est post_dataforseo_backlinks_competitors_live, et les deux listes divergent souvent — ce qui est en soi instructif.

Référence tarifaire

  • Mesure : coût de réponse déclaré.
  • Estimation de référence par requête : USD 0.0192.
  • 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)[]
    • filters
      Type: array (object | null)[] | null

      tableau de paramètres de filtrage des résultats
      champ facultatif
      vous pouvez ajouter plusieurs filtres à la fois (8 filtres maximum)
      vous devez définir un opérateur logique and, or entre les conditions
      les opérateurs suivants sont pris en charge :
      regex, not_regex, <, <=, >, >=, =, <>, in, not_in, match, not_match, ilike, not_ilike, like, not_like
      vous pouvez utiliser l'opérateur % avec like et not_like, ainsi qu'ilike et not_ilike, pour correspondre à toute chaîne de zéro ou plusieurs caractères
      exemple :
      ["median_position","in",[1,10]]

      [["median_position","in",[1,10]],"and",["domain","not_like","%wikipedia.org%"]]

      [["domain","not_like","%wikipedia.org%"],
      "and",
      [["relevant_serp_items",">",0],"or",["median_position","in",[1,10]]]]
      pour plus d'informations sur les filtres, consultez Dataforseo Labs - Filters ou ce guide du centre d'aide

      Objet vide
    • include_subdomains
      Type: boolean | null

      indique si les sous-domaines seront inclus dans la recherche
      champ facultatif
      si défini sur false, les sous-domaines seront ignorés
      valeur par défaut : true

    • item_types
      Type: array string[] | null

      type de résultats de recherche
      indique le type de résultats de recherche inclus dans la réponse
      champ facultatif

      valeurs possibles :
      ["organic", "paid", "featured_snippet", "local_pack"]
      valeur par défaut :
      ["organic", "paid"]

    • keywords
      Type: array string[]

      tableau de mots-clés
      champ obligatoire
      les résultats seront basés sur les mots-clés que vous spécifiez dans ce tableau
      encodage UTF-8 ;
      les mots-clés seront convertis en minuscules ;
      vous pouvez spécifier un maximum de 200 mots-clés

      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

      identifiant unique de langue
      champ obligatoire si vous ne spécifiez pas language_name
      Remarque : il est obligatoire de spécifier language_name ou language_code
      vous pouvez obtenir la liste des langues disponibles et leurs paramètres language_code en effectuant une requête distincte sur
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      exemple :
      en

    • language_name
      Type: string

      nom complet de la langue
      champ obligatoire si vous ne spécifiez pas language_code
      Remarque : il est obligatoire de spécifier language_name ou language_code
      vous pouvez obtenir la liste des langues disponibles et leurs paramètres language_name en effectuant une requête distincte sur
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      exemple :
      English

    • limit
      Type: integer | null

      nombre maximal de domaines renvoyés
      champ facultatif
      valeur par défaut : 100
      valeur maximale : 1000

    • location_code
      Type: integer

      identifiant unique d'emplacement
      champ obligatoire si vous ne spécifiez pas location_name
      Remarque : il est obligatoire de spécifier location_name ou location_code
      vous pouvez obtenir la liste des emplacements disponibles et leurs paramètres location_code en effectuant une requête distincte sur
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      exemple :
      2840

    • location_name
      Type: string

      nom complet de l'emplacement
      champ obligatoire si vous ne spécifiez pas location_code
      Remarque : il est obligatoire de spécifier location_name ou location_code
      vous pouvez obtenir la liste des emplacements disponibles et leurs paramètres location_name en effectuant une requête distincte sur
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      exemple :
      United Kingdom

    • offset
      Type: integer | null

      décalage dans le tableau de résultats des domaines renvoyés
      champ facultatif
      valeur par défaut : 0
      si vous spécifiez la valeur 10, les dix premiers domaines du tableau de résultats seront omis et les données seront fournies pour les domaines suivants

    • order_by
      Type: array string[] | null

      règles de tri des résultats
      champ facultatif
      vous pouvez utiliser les mêmes valeurs que dans le tableau filters pour trier les résultats
      types de tri possibles :
      asc - les résultats seront triés par ordre croissant
      desc - les résultats seront triés par ordre décroissant
      la virgule est utilisée comme séparateur
      exemple :
      ["avg_position,asc"]
      règle par défaut :
      ["rating,desc"]
      notez que vous pouvez définir au maximum trois règles de tri dans une seule requête
      vous devez utiliser une virgule pour séparer plusieurs règles de tri
      exemple :
      ["avg_position,asc","etv,desc"]

    • 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 spécifiée dans l'objet data de la réponse

Réponses
  • 200
    Type: object | null · Response36Afe1097B20_DataforseoLabsGoogleSerpCompetitorsLiveResponseInfo
    • 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_DataforseoLabsGoogleSerpCompetitorsLiveTaskInfo
        • 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

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

            contient les concurrents SERP détectés et les données associées

            • avg_position
              Type: number | null Format: float

              la position moyenne du domaine pour les mots-clés spécifiés
              la moyenne arithmétique des valeurs du tableau keywords_positions

            • domain
              Type: string | null

              nom de domaine du concurrent SERP détecté

            • etv
              Type: number | null

              volume de trafic estimé
              représente le trafic mensuel estimé que les mots-clés spécifiés génèrent vers le site web
              calculé comme la somme des produits des valeurs de volume de recherche des mots-clés spécifiés et des taux de CTR (click-through-rate) à certaines positions dans la SERP
              en savoir plus sur le calcul de la métrique dans cet article du centre d'aide

            • keywords_count
              Type: integer | null Format: int64

              le nombre de mots-clés spécifiés pour lesquels le domaine a des positions dans les SERP

            • keywords_positions
              Type: object | null

              positions des mots-clés
              positions dans la SERP que le domaine associé occupe dans la SERP pour les mots-clés spécifiés

              • propertyName
                Type: array (integer | null)[] | null
            • median_position
              Type: number | null

              la position médiane du domaine pour les mots-clés spécifiés
              la médiane des valeurs du tableau keywords_positions

            • rating
              Type: number | null

              la marge entre les positions de mots-clés maximales possibles et réelles
              représente le taux de visibilité relatif du domaine dans la SERP pour les mots-clés spécifiés
              calculé comme sum(100-keywords_positions)

            • relevant_serp_items
              Type: integer | null

              le nombre d'éléments SERP pertinents pour le domaine
              représente le nombre de résultats de recherche dans la SERP pertinents pour le domaine pour les mots-clés spécifiés

            • se_type
              Type: string | null

              type de moteur de recherche

            • visibility
              Type: number | null

              taux de visibilité dans la SERP
              représente le taux de visibilité du site web selon les positions dans la SERP des mots-clés spécifiés
              Les mots-clés dont les positions vont de 1 à 10 reçoivent l'indice de visibilité de 1 à 0,1, respectivement
              Les mots-clés dont les positions vont de 11 à 20 ont l'indice de visibilité fixe de 0,05
              les mots-clés dont les positions vont de 20 à 100 ont l'indice de visibilité égal à 0

          • 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
            s'il n'y a pas de données, la valeur est_nulln

          • location_code
            Type: integer | null

            code d'emplacement dans un tableau POST
            s'il n'y a pas de données, la valeur est_nulln

          • se_type
            Type: string | null

            type de moteur de recherche

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

            mots-clés spécifiés dans la requête
            le mot-clé est renvoyé avec %## décodé (le caractère plus '+' sera décodé en caractère espace)

          • total_count
            Type: integer | null Format: int64

            le nombre total de résultats de notre base de données correspondant à votre requête

        • 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/dataforseo_labs/google/serp_competitors/live
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/serp_competitors/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keywords": [
      "phone"
    ],
    "language_name": "English",
    "location_code": 2840,
    "item_types": [
      "organic"
    ],
    "limit": 5
  }
]'

{
  "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": [
        {
          "se_type": null,
          "seed_keywords": [
            null
          ],
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "domain": null,
              "avg_position": null,
              "median_position": null,
              "rating": null,
              "etv": null,
              "keywords_count": null,
              "visibility": null,
              "relevant_serp_items": null,
              "keywords_positions": null
            }
          ]
        }
      ]
    }
  ]
}

Opération réussie

SERP Competitors