DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Scraper LLM ChatGPT en direct
Pose un keyword à ChatGPT comme le ferait un utilisateur et renvoie la réponse analysée. Renvoie keyword, location_code, language_code, model, datetime, markdown, sources, fan_out_queries et brand_entities — markdown est la réponse telle que l'assistant l'a rendue, sources les pages citées et brand_entities les marques nommées. force_web_search le fait naviguer plutôt que répondre depuis son entraînement. Encapsulé dans l'enveloppe DataForSEO : les données dans tasks[0].result, le résultat dans tasks[0].status_code — une requête rejetée renvoie tout de même HTTP 200. C'est le point de terminaison pour « que dit ChatGPT de nous » ; pour compter les mentions sur de nombreuses réponses, utilisez post_dataforseo_ai_llm_mentions_aggregated_metrics_live plutôt que de scraper à répétition. La forme brute est post_dataforseo_ai_chat_gpt_llm_scraper_live_html.
Pricing reference
- Comptage : coût de réponse déclaré.
- Estimation de référence par requête : USD 0.004.
- Multiplicateur de référence du client : 1.0. Ne pas l'appliquer une nouvelle fois à un montant client déjà réglé.
Métadonnées de référence uniquement : ni devis de compte, ni prix garanti, ni 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)[]
- forceType: boolean | null
_web _search forcer l'agent IA à utiliser la recherche web
champ facultatif
lorsqu'il est activé, le modèle IA est forcé d'accéder aux informations web actuelles et de les citer ;
valeur par défaut :false;
Remarque : même si le paramètre est défini surtrue, rien ne garantit que des sources web seront citées dans la réponse - keywordType: string
mot-clé
champ obligatoire
vous pouvez spécifier jusqu'à 2000 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;
si vous utilisez ce champ, vous n'avez pas besoin de spécifierlanguage_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/ai_optimization/chat_gpt/llm_scraper/languages - languageType: string
_name nom complet de la langue du moteur de recherche
champ obligatoire si vous ne spécifiez paslanguage_code;
si vous utilisez ce champ, vous n'avez pas besoin de spécifierlanguage_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/ai_optimization/chat_gpt/llm_scraper/languages - locationType: integer
_code code d'emplacement du moteur de recherche
champ obligatoire si vous ne spécifiez paslocation_name
si vous utilisez ce champ, vous n'avez pas besoin de spécifierlocation_name
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/ai_optimization/chat_gpt/llm_scraper/locations
exemple :2840 - locationType: string
_name nom complet de l'emplacement du moteur de recherche
champ obligatoire si vous ne spécifiez paslocation_code
si vous utilisez ce champ, vous n'avez pas besoin de spécifierlocation_code
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/ai_optimization/chat_gpt/llm_scraper/locations
exemple :United States - 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_AiOptimizationChatGptLlmScraperLiveAdvancedResponseInfo200
- 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_AiOptimizationChatGptLlmScraperLiveAdvancedTaskInfo
- 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
- brandType: array (object | null)[] | null
_entities tableau d'entités de marque
contient des informations sur les marques mentionnées dans la réponse- categoryType: string | null
catégorie de la marque
- markdownType: string | null
- titleType: string | null
nom de la marque
- typeType: string | null
type d'élément
- urlsType: object | null
tableau d'URL et de domaines pertinents pour la marque
- checkType: string | null
_url URL directe vers les résultats du moteur de recherche
vous pouvez l'utiliser pour vérifier que nous fournissons des résultats exacts - datetimeType: string | null
date et heure de réception du résultat
au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
exemple :2019-11-15 12:57:46 +00:00 - fanType: array (string | null)[] | null
_out _queries tableau de requêtes fan-out
contient des requêtes de recherche associées dérivées de la requête principale afin de fournir une réponse plus complète - itemType: array (string | null)[] | null
_types types de résultats de recherche
contient les types de résultats de recherche (items) trouvés dans la SERP.
types d'éléments possibles :chat_gpt_text,chat_gpt_table,chat_gpt_navigation_list,chat_gpt_images,chat_gpt_local_businesses,chat_gpt_products - itemsType: array (object | null)[] | null
éléments des résultats ChatGPT
- rankType: integer | null
_absolute rang absolu dans la SERP
position absolue parmi tous les éléments - rankType: integer | null
_group rang de groupe dans les SERP
position au sein d'un groupe d'éléments ayant des valeurstypeidentiques
les positions des éléments ayant des valeurstypedifférentes sont omises derank_group - typeType: string | null
type d'élément
- itemsType: integer | null Format: int64
_count le nombre de résultats renvoyés dans le tableau
items - keywordType: string | null
mot-clé reçu dans un tableau POST
le mot-clé est renvoyé avec %## décodé (le symbole plus '+' sera décodé en espace) - languageType: string | null
_code code de langue dans un tableau POST
- locationType: integer | null
_code code de localisation dans un tableau POST
- markdownType: string | null
- modelType: string | null
indique la version du modèle
- seType: integer | null Format: int64
_results _count nombre total de résultats
- searchType: array (object | null)[] | null
_results tableau de résultats de recherche
toutes les sorties de recherche web récupérées par le modèle lors de la recherche d'informations, y compris les doublons et les entrées inutilisées- breadcrumbType: string | null
fil d'Ariane
- descriptionType: string | null
description du résultat
- domainType: string | null
domaine du résultat
- titleType: string | null
titre du résultat
- typeType: string | null
type d'élément
- urlType: string | null
URL du résultat
- sourcesType: array (object | null)[] | null
tableau de sources
les sources que le modèle a réellement citées ou utilisées dans sa réponse finale- domainType: string | null
domaine de la source dans la SERP
- markdownType: string | null
- publicationType: string | null
_date date et heure de publication du résultat
au format : “année-mois-jour:minutes:heures_de_décalage_UTC:minutes_de_décalage_UTC”
exemple :2019-11-15 12:57:46 +00:00 - snippetType: string | null
description de la source
- sourceType: string | null
_name nom de la source
- thumbnailType: string | null
miniature de la source
- titleType: string | null
titre de la source
- typeType: string | null
type d'élément
- urlType: string | null
URL source
- 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/ai_optimization/chat_gpt/llm_scraper/live/advanced \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"keyword": "albert einstein"
}
]'
{
"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": [
{
"keyword": null,
"location_code": null,
"language_code": null,
"model": null,
"check_url": null,
"datetime": null,
"markdown": null,
"search_results": [
{
"type": null,
"url": null,
"domain": null,
"title": null,
"description": null,
"breadcrumb": null
}
],
"sources": [
{
"type": null,
"title": null,
"snippet": null,
"domain": null,
"url": null,
"thumbnail": null,
"source_name": null,
"publication_date": null,
"markdown": null
}
],
"fan_out_queries": [
null
],
"brand_entities": [
{
"type": null,
"title": null,
"category": null,
"markdown": null,
"urls": null
}
],
"se_results_count": null,
"item_types": [
null
],
"items_count": null,
"items": [
{
"type": null,
"rank_group": null,
"rank_absolute": null
}
]
}
]
}
]
}