Configurer des tâches SERP organique Baidu
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Configurer des tâches SERP organique Baidu
Met en file d'attente les résultats classés d'un mot-clé sur Baidu 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.
- Type: array (object | null)[]
- depthType: 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. - deviceType: string | null
type d'appareil
champ facultatif
renvoyer les résultats pour un type d'appareil particulier
peut prendre les valeurs :desktop,mobile,tablet
valeur par défaut :desktop - getType: boolean | null
_website _url inclure l'URL directe pour chaque résultat classé
champ facultatif
si la valeur esttrue, les résultats renvoyés contiendront les URL directes des sites web classés
par défaut, les URL des résultats Baidu sont encodées par le moteur de recherche,
par exemple :http://www.baidu.com/link?url=KQt6LSwU5OHnPtB8210R8flBP40grY6lTPxH_0UO7S2kgiZMTmw3ztV0hCo5c1kLvaleur par défaut :false
Remarque : si la valeur esttrue, le coût par tâche sera multiplié par 10, car notre système effectue une requête distincte pour chaque site web classé afin de renvoyer son URL directe - keywordType: string
mot-clé
champ obligatoire
vous pouvez indiquer jusqu'à 700 caractères dans le champkeyword
tous les %## seront décodés (le caractère ‘+’ sera décodé en espace)
si vous devez utiliser le caractère “%” dans votrekeyword, spécifiez-le comme “%25” ;
si vous devez utiliser le caractère “+” dans votrekeyword, spécifiez-le comme “%2B”en savoir plus sur les règles et limites des champs
keywordetkeywordsdans les API DataForSEO dans cet article du centre d'aide - languageType: string
_code code de langue du moteur de recherche
champ obligatoire si vous ne spécifiez paslanguage_name
vous pouvez obtenir la liste des langues disponibles du moteur de recherche avec leurlanguage_codeen effectuant une requête distincte surhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesremarque : la seule langue prise en charge par le moteur de recherche Baidu estChinese (Simplified), avec le code de languezh_CN. Toutefois, Baidu peut également renvoyer des résultats pour des requêtes dans d'autres langues ; indiquer lekeyworden chinois n'est donc pas obligatoireexemple :
zh_CN - languageType: string
_name nom complet de la langue du moteur de recherche
champ obligatoire si vous ne spécifiez paslanguage_code
vous pouvez obtenir la liste des langues disponibles du moteur de recherche avec leurlanguage_nameen effectuant une requête distincte surhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesremarque : la seule langue prise en charge par le moteur de recherche Baidu estChinese (Simplified). Toutefois, Baidu peut également renvoyer des résultats pour des requêtes dans d'autres langues ; indiquer lekeyworden chinois n'est donc pas obligatoireexemple :
Chinese (Simplified) - locationType: integer
_code code d'emplacement du moteur de recherche
champ obligatoire si vous ne spécifiez paslocation_nameoulocation_coordinate
si vous utilisez ce champ, vous n'avez pas besoin de spécifierlocation_nameoulocation_coordinate
vous pouvez obtenir la liste des emplacements disponibles des moteurs de recherche avec leurlocation_codeen effectuant une requête distincte surhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
exemple :2156 - locationType: string
_coordinate coordonnées GPS d'une localisation
champ obligatoire si vous ne spécifiez paslocation_nameoulocation_code
si vous utilisez ce champ, vous n'avez pas besoin de spécifierlocation_nameoulocation_code
le paramètrelocation_coordinatedoit être indiqué au format "latitude,longitude,radius"
le nombre maximal de décimales pour "latitude" et "longitude" : 7
la valeur minimale pour "radius" : 199.9 (mm)
la valeur maximale pour "radius" : 199999 (mm)si vous utilisez ce champ, les résultats renvoyés seront basés sur la ville la plus proche trouvée pour vos coordonnées. Par conséquent, nous ne recommandons pas d'utiliser ce champ, car les résultats peuvent ne pas être pertinents pour les coordonnées indiquées
exemple :53.476225,-2.243572,200 - locationType: string
_name nom complet de l'emplacement du moteur de recherche
champ obligatoire si vous ne spécifiez paslocation_codeoulocation_coordinate
si vous utilisez ce champ, vous n'avez pas besoin de spécifierlocation_codeoulocation_coordinate
vous pouvez obtenir la liste des emplacements disponibles du moteur de recherche avec leurlocation_nameen effectuant une requête distincte surhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
exemple :New York,New York,United States - maxType: integer | null
_crawl _pages - osType: string | null
système d'exploitation de l'appareil
champ facultatif
si vous indiquezdesktopdans le champdevice, choisissez parmi les valeurs suivantes :windows,macos
valeur par défaut :windows
si vous indiquezmobiledans le champdevice, choisissez parmi les valeurs suivantes :android,ios
valeur par défaut :android
si vous indiqueztabletdans le champdevice, choisissez parmi les valeurs suivantes :android,ios
valeur par défaut :android - pingbackType: string | null
_url 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$idet ‘$tag’ comme variable$tagencodée pour URL. Nous définirons les valeurs nécessaires avant d'envoyer la requête.
exemple :http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Remarque : les caractères spéciaux depingback_urlseront encodés pour URL ;
notamment, le caractère#sera encodé en%23 - postbackType: string
_data type de données de postback_url
champ obligatoire si vous spécifiezpostback_url
correspond au type de données qui sera envoyé à votre serveur
valeurs possibles :regular,html - postbackType: string | null
_url 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 avec ses résultats compressés au formatgzipà l'adressepostback_urlque vous avez spécifiée
vous pouvez utiliser la chaîne ‘$id’ comme variable$idet ‘$tag’ comme variable$tagencodée pour URL. Nous définirons les valeurs nécessaires avant d'envoyer la requête.
exemple :http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Remarque : les caractères spéciaux depostback_urlseront encodés pour URL ;
notamment, le caractère#sera encodé en%23 - priorityType: integer | null
- stopType: array (object | null)[] | null
_crawl _on _match 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
- matchType: string | null
_type 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
- matchType: string | null
_value 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
- tagType: 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 valeurtagspécifiée dans l'objetdatade la réponse
- Type: object | null · Response36Afe1097B20_SerpBaiduOrganicTaskPostResponseInfo200
- Type: number | null Format: doublecost
coût total des tâches, USD
- Type: integer | nullstatus
_code code d'état général vous pouvez trouver la liste complète des codes de réponse ici
- Type: string | nullstatus
_message message d'information général vous pouvez trouver la liste complète des messages d'information généraux ici
- Type: array (object | null)[] | nulltasks
tableau de tâches
- Type: object | null · Response36Afe1097B20_SerpBaiduOrganicTaskPostTaskInfo
- costType: number | null Format: double
coût total des tâches, USD
- dataType: object | null
contient les mêmes paramètres que ceux spécifiés dans la requête POST
- propertyType: object | null
Name
- idType: string | null
identifiant de la tâche identifiant unique de la tâche dans notre système au format UUID
- pathType: array (string | null)[] | null
chemin de l'URL
- resultType: object | null
tableau de résultats
dans ce cas, la valeur seranull - resultType: integer | null Format: int64
_count nombre d'éléments dans le tableau de résultats
- statusType: integer | null
_code 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
- statusType: string | null
_message message d'information de la tâche vous pouvez trouver la liste complète des messages d'information généraux ici
- timeType: string | null
temps d'exécution, en secondes
- Type: integer | null Format: int64tasks
_count le nombre de tâches dans le tableau de tâches
- Type: integer | null Format: int64tasks
_error le nombre de tâches dans le tableau de tâches renvoyées avec une erreur
- Type: string | nulltime
temps d'exécution total, en secondes
- Type: string | nullversion
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
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/baidu/organic/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"location_code": 2156,
"keyword": "best iphone ever",
"tag": "some_string_123",
"priority": 2
}
]'
{
"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
}
]
}