Interroger un moteur de réponses IA pour la visibilité GEO/AEO.
Oxylabs
AI-assisted web search.
Interroger un moteur de réponses IA pour la visibilité GEO/AEO.
Exécute une recherche synchrone assistée par IA avec la source google_search ou google_ai_mode et les autres champs de requête documentés. Ce point de terminaison n'accepte pas chatgpt, gemini ou perplexity comme sources synchrones.
Référence tarifaire
- Mesure : base de coût fixe par requête réussie.
- Estimation de référence par requête : USD 0.00145.
- Multiplicateur client de référence : 1.45. 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.
Corps transmis tel quel pour les moteurs de réponses Google. source sélectionne le moteur ; query, render, parse et geo_location sont les paramètres attendus par les sources Google. Les paramètres amont supplémentaires sont transmis tels quels.
- Type: string enumsourceobligatoire
Le moteur de réponses IA de Google à interroger.
google_searchrenvoie Google AI Overviews ;google_ai_moderenvoie Google AI Mode. Pour ChatGPT/Gemini/Perplexity, utilisez plutôt le point de terminaison asynchronepost_oxylabs_llm.valeurs- google
_search - google
_ai _mode
- Type: stringgeo
_location Géolocalisation au niveau du pays pour la requête, par exemple "United States".
- Type: booleanparse
Renvoie des résultats structurés et analysés au lieu de la sortie brute. Recommandé pour toutes les sources.
- Type: stringquery
La requête de recherche. Obligatoire pour
google_searchetgoogle_ai_mode. - enumrenderconstante:html
Pour
google_searchetgoogle_ai_mode, définissez "html" pour afficher la page avant l'analyse.valeurs- html
- Type: anythingproperty
Name
- Type: object200
Requête terminée avec succès.
results[]contient un résultat par requête. La forme analysée danscontentvarie selon la source (voir les descriptions des propriétés) ; l'exemple ci-dessous montre la formegoogle_search(Google AI Overviews).- Type: array object[]results
Une entrée par requête. Une requête unique Realtime renvoie exactement un résultat, qui constitue l'unité facturée.
- contentType: object
Payload de la réponse analysée. La structure varie selon la source Google :
google_search→content.results.ai_overviews[]avecanswer_textetreferences[]{source, url}(illustré ci-dessous).google_ai_mode→content.citations[]{text, urls[]}.
- resultsType: object
Conteneur de résultats analysés de type Google.
- aiType: array object[]
_overviews Google AI Overviews renvoyés pour la requête.
- answerType: array object[]
_text La réponse générée par IA, découpée en fragments pouvant contenir des références intégrées.
- fragmentsType: array object[]
- referencesType: array
- referencesType: array object[]
Sources citées pour cette vue d'ensemble.
- sourceType: string
- urlType: string
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/oxylabs/ai-search \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"source": "google_search",
"query": "best noise cancelling headphones 2026",
"parse": true,
"render": "html",
"geo_location": "United States"
}'
{
"results": [
{
"content": {
"results": {
"ai_overviews": [
{
"answer_text": [
{
"fragments": [
{
"references": "[Max Depth Exceeded]"
}
]
}
],
"references": [
{
"source": "string",
"url": "string"
}
]
}
]
}
}
}
]
}