Synup
Créer une clé
v1Ressources/AEO/getObtenir l'historique des vérifications d'un prompt suivi

Obtenir l'historique des vérifications d'un prompt suivi

Renvoie, de la plus récente à la plus ancienne, les vérifications qui ont capturé ce prompt parmi les 100 vérifications les plus récentes du site web : la formulation mesurée par chacune, son statut et les réponses de cette formulation par moteur. Seules les vérifications sont listées — une formulation enregistrée mais jamais vérifiée n'apparaît pas — et les anciennes formulations restent listées après une modification ou une suppression. Lecture seule. Un prompt qu'aucune vérification n'a capturé renvoie une liste vide.

get/api/v1/aeo/prompts/{promptId}/history
aeo:read
Paramètres de requête
promptIdstringobligatoire
L'id du prompt suivi.
locationIdstringobligatoire
L'id d'établissement de l'entité site web. Un site web que vous ne pouvez pas voir, ou qui n'existe pas, renvoie 404 ; un établissement physique renvoie 422 entity_type_not_supported.
Réponse
dataobjectfacultatif
promptIdstringfacultatif
L'id du prompt suivi.
checksarray of objectfacultatif
Les vérifications qui ont capturé ce prompt, de la plus récente à la plus ancienne, parmi les 100 vérifications les plus récentes du site web.
collectionIdstringfacultatif
Identifiant unique de la vérification.
capturedAtstringfacultatif
Quand la vérification a capturé les prompts qu'elle mesure, sous forme d'horodatage ISO 8601.
settledAtstringfacultatif
Quand la vérification s'est terminée, ou null tant qu'elle est en cours.
statusstring (captured | running | complete | partial | failed | held)facultatif
captured, running, complete, partial (certaines réponses manquent), failed ou held (le résultat est inconnu et doit être rapproché ; ni terminée ni en échec). Une vérification failed ou held peut s'être arrêtée avant que toutes les réponses attendues aient été demandées.
wordingVersionintegerfacultatif
La version de la formulation : 1 à la création, augmentée de un à chaque modification de formulation. Renvoyez-la comme expectedWordingVersion.
textstringfacultatif
La formulation du prompt. Dans une vérification ou une entrée d'historique, la formulation mesurée par cette vérification.
observationsarray of objectfacultatif
promptIdstringfacultatif
L'id du prompt suivi.
wordingVersionintegerfacultatif
La version de la formulation : 1 à la création, augmentée de un à chaque modification de formulation. Renvoyez-la comme expectedWordingVersion.
promptTextstringfacultatif
La formulation du prompt. Dans une vérification ou une entrée d'historique, la formulation mesurée par cette vérification.
enginestringfacultatif
Le moteur d'IA qui a répondu.
outcomestring (measured | unusable | failed)facultatif
measured (une réponse exploitable), unusable (le moteur a répondu, mais la réponse n'a pas pu être évaluée) ou failed (pas de réponse). Seul measured est un résultat ; les autres ne sont jamais lus comme zéro.
mentionedbooleanfacultatif
Indique si l'entreprise a été mentionnée dans la réponse.
ranknumberfacultatif
La position de l'entreprise parmi les mentions, ou null si elle n'a été ni mentionnée ni classée.
scorenumberfacultatif
Score dérivé du rang pour cette réponse, 0-100, ou null s'il n'y en a pas.
answerExcerptstringfacultatif
Un extrait de la réponse du moteur, ou null si aucun n'a été conservé.
enginesarray of stringfacultatif
Les moteurs d'IA sélectionnés pour cette vérification.
Erreurs
401Clé API manquante, invalide, expirée ou révoquée.
403La clé n'a pas la permission requise, ou n'est pas autorisée pour ce client/établissement.
404La ressource est introuvable, ou n'appartient pas à votre agence.
422Il manque un paramètre requis à la requête, ou elle est invalide.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
503Le service est temporairement indisponible. Suivez les consignes de nouvelle tentative propres à cette opération.
get/api/v1/aeo/prompts/{promptId}/history
Votre clé API
promptId *
locationId *
{}

Guides qui utilisent cette ressource