Capture d'écran de page de l'API SERP
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Capture d'écran de page de l'API SERP
Renvoie une capture d'écran rendue d'une page de résultats de recherche Google. 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.
- Type: array (object | null)[]
- browserType: string | null
_preset préréglage de résolution du navigateur
champ facultatif
préréglage de navigateur associé à un certain type d'appareil
peut prendre les valeurs suivantes :desktop,tablet,mobile
Remarque : par défaut, le préréglage du navigateur correspond au type d'appareil indiqué dans la requête POST - browserType: integer | null
_screen _height hauteur de la résolution du navigateur
champ facultatif
peut être indiquée dans la plage suivante :240-9999
valeur par défaut pourdesktop: 1080
valeur par défaut pourmobile: 844
valeur par défaut pourtable: 1366 - browserType: number | null
_screen _scale _factor facteur d'échelle du navigateur
champ facultatif
peut être indiqué dans la plage suivante :0.5-3
valeur par défaut pourdesktop: 1
valeur par défaut pourmobile: 3
valeur par défaut pourtable: 2 - browserType: integer | null Format: int64
_screen _width largeur de la résolution du navigateur
champ facultatif
peut être indiquée dans la plage suivante :240-9999
valeur par défaut pourdesktop: 1920
valeur par défaut pourmobile: 390
valeur par défaut pourtable: 1024 - pageType: integer | null
nombre de pages SERP
champ facultatif
sidepthdans la requête Task POST correspondante dépasse 10 résultats (ou 1 page SERP), indiquez le nombre de pages SERP à capturer ;
valeur par défaut :1 - taskType: string
_id
- Type: object | null · Response36Afe1097B20_SerpScreenshotResponseInfo200
- 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_SerpScreenshotTaskInfo
- 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: array (object | null)[] | null
tableau de résultats
- itemsType: array (object | null)[] | null
tableau items
- imageType: string | null
capture d'écran de la page demandée
URL de la capture d'écran de la page sur le stockage DataForSEO
remarque : la capture d'écran enregistrée sur le stockage DataForSEO reste accessible un jour seulement après l'exécution de la requête
- itemsType: integer | null Format: int64
_count nombre d'éléments du tableau de résultats
- 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/screenshot \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"task_id": "06211235-0696-0139-1000-36727fbd3c90",
"browser_screen_scale_factor": 0.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": [
{
"items_count": null,
"items": [
{
"image": null
}
]
}
]
}
]
}