Configurer les tâches SERP Google Events
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Configurer les tâches SERP Google Events
Met en file d'attente les événements que Google fait remonter pour une requête, 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[]
- keywordType: stringobligatoire
Mot-clé à rechercher
- languageType: string
_code Code de langue du moteur de recherche
- languageType: string
_name Nom complet de la langue du moteur de recherche
- locationType: integer
_code Code d'emplacement du moteur de recherche
- locationType: string
_coordinate Coordonnées GPS d'un emplacement
- locationType: string
_name Nom complet de l'emplacement du moteur de recherche
- pingbackType: string
_url URL de notification d'une tâche terminée
- postbackType: string
_data Type de données de postback
- postbackType: string
_url URL d'envoi des résultats de la tâche
- priorityType: integer
Priorité de la tâche
- Type: object200
Réponse réussie
- Type: numbercost
Coût total des tâches, USD
- Type: integerstatus
_code Code d'état général
- Type: stringstatus
_message Message d'information général
- Type: array string[]tasks
Tableau d'objets de tâche
- Type: integertasks
_count Nombre de tâches dans le tableau de tâches
- Type: integertasks
_error Nombre de tâches du tableau de tâches renvoyées avec une erreur
- Type: numbertasks[]
.cost Coût de la tâche, USD
- Type: stringtasks[]
.id Identifiant de la tâche au format UUID
- Type: integertasks[]
.result _count Nombre d'éléments dans le tableau de résultats
- Type: integertasks[]
.status _code Code d'état de la tâche
- Type: stringtasks[]
.status _message Message d'état de la tâche
- Type: stringtime
Temps d'exécution, secondes
- Type: stringversion
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/google/events/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keyword": "",
"location_code": 1,
"location_name": "",
"location_coordinate": "",
"language_code": "",
"language_name": "",
"priority": 1,
"postback_url": "",
"pingback_url": "",
"postback_data": ""
}
]'
{
"version": "string",
"status_code": 1,
"status_message": "string",
"time": "string",
"cost": 1,
"tasks_count": 1,
"tasks_error": 1,
"tasks": [
"string"
],
"tasks[].id": "string",
"tasks[].status_code": 1,
"tasks[].status_message": "string",
"tasks[].cost": 1,
"tasks[].result_count": 1
}