v0.2.0-beta

OpenAPI 3.1.0

Configurer des tâches SERP organique Bing

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/bing/organic/task_post

Configurer des tâches SERP organique Bing

Met en file d'attente les résultats classés d'un mot-clé sur Bing et renvoie un id de tâche dans tasks[0].id. 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. Le jumeau en direct répond immédiatement et reste plus simple pour une requête unique ; mettez en file d'attente lorsque le lot dépasserait un appel d'outil.

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)[]
- browser_screen_height
  Type: integer | null
  
  hauteur d'écran du navigateur
  
  champ facultatif
  
  vous pouvez définir une hauteur d'écran de navigateur personnalisée pour calculer le classement en pixels d'un appareil particulier;
  
  elle peut être définie dans la plage suivante : 240-9999 ;
  
  par défaut, le paramètre est défini sur :
  
  1080 pour desktop ;
  
  640 pour mobile sur android ;
  
  812 pour mobile sur iOS ;
  
  Remarque : pour utiliser ce paramètre, définissez calculate_rectangles sur true
- browser_screen_resolution_ratio
  Type: integer | null
  
  ratio de résolution d'écran du navigateur
  
  champ facultatif
  
  vous pouvez définir un ratio de résolution d'écran de navigateur personnalisé pour calculer le classement en pixels d'un appareil particulier;
  
  il peut être défini dans la plage suivante : 0.5-3 ;
  
  par défaut, le paramètre est défini sur :
  
  1 pour desktop ;
  
  3 pour mobile sur android ;
  
  3 pour mobile sur iOS ;
  
  Remarque : pour utiliser ce paramètre, définissez calculate_rectangles sur true
- browser_screen_width
  Type: integer | null Format: int64
  
  largeur d'écran du navigateur
  
  champ facultatif
  
  vous pouvez définir une largeur d'écran de navigateur personnalisée pour calculer le classement en pixels d'un appareil particulier;
  
  elle peut être définie dans la plage suivante : 240-9999 ;
  
  par défaut, le paramètre est défini sur :
  
  1920 pour desktop ;
  
  360 pour mobile sur android ;
  
  375 pour mobile sur iOS ;
  
  Remarque : pour utiliser ce paramètre, définissez calculate_rectangles sur true
- calculate_rectangles
  Type: boolean | null
  
  calculer le classement en pixels des éléments du SERP dans les résultats avancés
  
  champ facultatif
  
  le classement en pixels désigne la distance entre l'extrait du résultat et le coin supérieur gauche de l'écran ;
  
  Consultez le centre d'aide pour en savoir plus>>
  
  par défaut, le paramètre est défini sur false
  
  Remarque : l'utilisation de ce paramètre vous sera facturée 0,0006 $ de plus
- depth
  Type: integer | null
  
  profondeur d'analyse
  
  champ facultatif
  
  nombre de résultats dans le SERP
  
  valeur par défaut : 10
  
  valeur maximale : 700
  
  Votre compte sera facturé pour chaque SERP contenant jusqu'à 10 résultats ;
  Définir une profondeur supérieure à 10 peut entraîner des frais supplémentaires si le moteur de recherche renvoie plus de 10 résultats ;
  
  Le coût peut être calculé sur la page Tarifs.
- device
  Type: string | null
  
  type d'appareil
  
  champ facultatif
  
  renvoyer les résultats pour un type d'appareil particulier
  
  peut prendre les valeurs :desktop, mobile
  
  valeur par défaut : desktop
- 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, spécifiez-le comme "%25" ;
  
  si vous devez utiliser le caractère “+” dans votre keyword, spécifiez-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
  
  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/{{low_se_name}}/languages
  
  exemple :
  
  en
- language_name
  Type: string
  
  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/{{low_se_name}}/languages
  
  exemple :
  
  English
- location_code
  Type: integer
  
  code d'emplacement du moteur de recherche
  
  champ obligatoire si vous ne spécifiez pas location_name ou location_coordinate
  
  si vous utilisez ce champ, vous n'avez pas besoin de spécifier location_name ou location_coordinate
  
  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/{{low_se_name}}/locations
  
  exemple :
  
  2840
- location_coordinate
  Type: string
  
  coordonnées GPS d'une localisation
  
  champ obligatoire si vous ne spécifiez pas location_name ou location_code
  
  si vous utilisez ce champ, vous n'avez pas besoin de spécifier location_name ou location_code
  
  le paramètre location_coordinate doit être indiqué au format "latitude,longitude"
  
  le nombre maximal de décimales pour "latitude" et "longitude" : 7
  
  exemple :
  
  53.476225,-2.243572
- location_name
  Type: string
  
  nom complet de l'emplacement du moteur de recherche
  
  champ obligatoire si vous ne spécifiez pas location_code ou location_coordinate
  
  si vous utilisez ce champ, vous n'avez pas besoin de spécifier location_code ou location_coordinate
  
  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/{{low_se_name}}/locations
  
  exemple :
  
  London,England,United Kingdom
- match_type
  Type: string
  
  type de correspondance de cible
  
  champ obligatoire si stop_crawl_on_match est spécifié
  
  type de correspondance pour match_value
  
  valeurs possibles :
  
  domain – domaine ou sous-domaine spécifique
  
  with_subdomains – domaine principal et sous-domaines
  
  wildcard – modèle générique
- match_value
  Type: string
  
  domaine, sous-domaine ou valeur générique de cible
  
  champ obligatoire si stop_crawl_on_match est spécifié
  
  indiquez un domaine, un sous-domaine ou une valeur générique de cible ;
  
  Remarque : le domaine ou le sous-domaine doit être indiqué sans protocole de requête ;
  
  exemple : "match_value": "dataforseo.com",
  
  "match_value": "/blog/post-*"
- max_crawl_pages
  Type: integer | null
  
  limite de pages explorées
  
  champ facultatif
  
  nombre de pages de résultats de recherche à explorer
  
  valeur par défaut : 1
  
  valeur maximale : 100
  
  Remarque : les paramètres max_crawl_pages et depth se complètent ;
  
  en savoir plus dans notre centre d'aide
- os
  Type: string | null
  
  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
- pingback_url
  Type: string | null
  
  URL de notification d'une tâche terminée
  
  champ facultatif
  
  lorsqu'une tâche est terminée, nous vous en informons par une requête GET envoyée à l'URL que vous avez spécifiée
  
  vous pouvez utiliser la chaîne ‘$id’ comme variable $id et ‘$tag’ comme variable $tag encodée pour URL. Nous définirons les valeurs nécessaires avant d'envoyer la requête.
  
  exemple :
  
  http://your-server.com/pingscript?id=$id
  
  http://your-server.com/pingscript?id=$id&tag=$tag
  
  Remarque : les caractères spéciaux de pingback_url seront encodés pour URL ;
  
  notamment, le caractère # sera encodé en %23
  
  en savoir plus dans notre centre d'aide
- postback_data
  Type: string
  
  type de données de postback_url
  
  champ obligatoire si vous spécifiez postback_url
  
  correspond au type de données qui sera envoyé à votre serveur
  
  valeurs possibles :
  
  regular, advanced, html
- postback_url
  Type: string | null
  
  URL d'envoi des résultats de la tâche
  
  champ facultatif
  
  une fois la tâche terminée, nous enverrons une requête POST contenant ses résultats compressés au format gzip à la postback_url que vous avez spécifiée
  
  vous pouvez utiliser la chaîne ‘$id’ comme variable $id et ‘$tag’ comme variable $tag encodée pour l'URL. Nous définirons les valeurs nécessaires avant d'envoyer la requête.
  
  exemple :
  
  http://your-server.com/postbackscript?id=$id
  
  http://your-server.com/postbackscript?id=$id&tag=$tag
  
  Remarque : les caractères spéciaux de postback_url seront encodés pour l'URL ;
  
  autrement dit, le caractère # sera encodé en %23
  
  en savoir plus sur notre centre d'aide
- priority
  Type: integer | null
  
  priorité de la tâche
  
  champ facultatif
  
  peut prendre les valeurs suivantes :
  
  1 – priorité d'exécution normale (définie par défaut)
  
  2 – priorité d'exécution élevée
  
  Les tâches à priorité d'exécution élevée sont facturées en supplément.
  Le coût peut être calculé sur la page Tarifs.
- search_param
  Type: string | null
  
  paramètres supplémentaires de la requête de recherche
  
  champ facultatif
  
  obtenez la liste des paramètres disponibles et plus de détails ici
- stop_crawl_on_match
  Type: array (object | null)[] | null
  
  tableau de cibles pour arrêter l'exploration champ facultatif s'il est indiqué, la réponse contiendra les résultats SERP jusqu'au match_value indiqué inclus ; vous pouvez indiquer jusqu'à 10 valeurs de cible dans ce tableau exemple : "stop_crawl_on_match":[{"match_value":"dataforseo.com","match_type":"with_subdomains"}] en savoir plus sur ce paramètre dans notre centre d'aide - https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api Votre compte sera facturé pour chaque SERP explorée via les cibles indiquées
  
  match_type
  Type: string | null
  
  type de correspondance de la cible champ obligatoire si stop_crawl_on_match est indiqué ; type de correspondance pour match_value valeurs possibles : domain, with_subdomains, wildcard
  
  match_value
  Type: string | null
  
  domaine ou valeur générique de cible champ obligatoire si stop_crawl_on_match est indiqué ; indiquez un domaine ou une valeur générique de cible ; Remarque : le nom de domaine doit être indiqué sans protocole de requête ; exemple : dataforseo.com
- 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
- url
  Type: string | null
  
  URL directe de la requête de recherche
  
  champ facultatif
  
  vous pouvez indiquer une URL directe et nous la décomposerons dans les champs nécessaires. Notez que cette méthode est la plus difficile à traiter pour notre API et qu'elle exige également que vous indiquiez la langue et l'emplacement exacts dans l'URL. Dans la plupart des cas, nous ne recommandons pas d'utiliser cette méthode.
  
  exemple :
  
  https://www.bing.com/search?q=rank%20checker&count=50&first=1&setlang=en&cc=US&safesearch=Moderate&FORM=SEPAGE

Réponses

200
Type: object | null · Response36Afe1097B20_SerpBingOrganicTaskPostResponseInfo
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_SerpBingOrganicTaskPostTaskInfo
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: object | null

tableau de résultats
dans ce cas, la valeur sera null

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/bing/organic/task_post

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

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": null
    }
  ]
}

Opération réussie

Configurer des tâches SERP organique Bing

AuthentificationRequired

DataForSEO

Configurer des tâches SERP organique Bing

Référence tarifaire