Suivre les moteurs de recherche AI

Utilisez /batches avec un parseur GEO/AEO (Optimisation des moteurs génératifs / Optimisation des moteurs de réponse) pour interroger un moteur de recherche AI à grande échelle et obtenir un JSON structuré en retour : la réponse, les citations et les surfaces commerciales telles que les publicités, les cartes d’achat et les modules de produits. Cette page couvre comment appeler /v1/batches et des aperçus compacts du JSON que vous recevez.

Moteurs

Chaque moteur nécessite son propre ID de parseur et modèle d’URL. Passez le parseur une fois au niveau du lot. Encodez la requête dans l’URL.

Moteur	Parseur	Modèle d’URL	Crédits	Articles max
Google AI Mode	`@olostep/google-aimode-results`	`https://www.google.com/aimode?q={query}`	3	2500
Google AI Overview	`@olostep/google-ai-overview-results`	`https://www.google.com/search?q={query}`	3	2500
ChatGPT	`@olostep/chatgpt-results`	`https://chatgpt.com/?q={query}`	5	2500
Perplexity	`@olostep/perplexity-results`	`https://www.perplexity.ai/?q={query}`	3	2500
Gemini	`@olostep/gemini-results`	`https://gemini.google.com/?q={query}`	3	2500
Microsoft Copilot	`@olostep/microsoft-copilot-results`	`https://copilot.microsoft.com/chats?q={query}`	3	1000

Les six prennent en charge le ciblage géographique via le paramètre country du lot (ISO 3166-1 alpha-2). La couverture des pays diffère selon le parseur — récupérez la liste en direct plutôt que de la coder en dur :

curl "https://api.olostep.com/v1/countries?service=batches&parser=@olostep/google-aimode-results"

Utilisez une invite informative (what is mitochondria) lorsque vous vous souciez des citations. Utilisez une invite commerciale (best wireless headphones under $200) lorsque vous avez besoin de publicités, de cartes d’achat ou de modules de produits — ces surfaces sont détectées par intention et omises lorsque le moteur ne les rend pas.

Tarification

Voici notre tarification publique pour les clients en libre-service. Nous offrons de meilleurs tarifs et des remises sur volume pour les clients d’entreprise. Nous proposons également des connecteurs personnalisés pour des plateformes spécialisées et des moteurs LLM. Contactez-nous par email ou Slack.

1. Créer le lot

custom_id doit être unique au sein du lot. country est appliqué à chaque élément.

from olostep import Olostep
from urllib.parse import quote_plus

client = Olostep(api_key="YOUR_API_KEY")

queries = [
    "what is mitochondria",
    "best wireless headphones under $200",
]

batch = client.batches.create(
    urls=[
        {
            "custom_id": f"aimode-{i}",
            "url": f"https://www.google.com/aimode?q={quote_plus(q)}",
        }
        for i, q in enumerate(queries, start=1)
    ],
    parser="@olostep/google-aimode-results",
    country="US",
)

print(batch.id, batch.status)

import Olostep from 'olostep'

const client = new Olostep({ apiKey: 'YOUR_API_KEY' })

const queries = [
  'what is mitochondria',
  'best wireless headphones under $200',
]

const batch = await client.batches.create(
  queries.map((q, i) => ({
    customId: `aimode-${i + 1}`,
    url: `https://www.google.com/aimode?q=${encodeURIComponent(q)}`,
  })),
  {
    parser: '@olostep/google-aimode-results',
    country: 'US',
  }
)

console.log(batch.id, batch.status)

curl -X POST "https://api.olostep.com/v1/batches" \
  -H "Authorization: Bearer $OLOSTEP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "parser": { "id": "@olostep/google-aimode-results" },
    "country": "US",
    "items": [
      {
        "custom_id": "aimode-1",
        "url": "https://www.google.com/aimode?q=what%20is%20mitochondria"
      },
      {
        "custom_id": "aimode-2",
        "url": "https://www.google.com/aimode?q=best%20wireless%20headphones%20under%20%24200"
      }
    ]
  }'

Pour cibler un moteur différent, gardez la même forme items et échangez parser.id plus l’hôte dans chaque URL. Un lot = un parseur.

Le temps de traitement est à peu près constant, quelle que soit la taille du lot (typiquement 5–8 minutes). Passez webhook à la création pour obtenir batch.completed au lieu de sonder. Les nouveaux comptes sont limités à 100 articles par lot — contactez info@olostep.com pour augmenter cette limite.

2. Attendre la complétion

Sondez GET /v1/batches/{batch_id} jusqu’à ce que status soit completed, ou gérez le webhook.

import time
import requests

headers = {"Authorization": f"Bearer {API_KEY}"}

def wait_for_batch(batch_id):
    while True:
        info = requests.get(
            f"https://api.olostep.com/v1/batches/{batch_id}",
            headers=headers,
        ).json()
        if info["status"] == "completed":
            return info
        time.sleep(15)

async function waitForBatch(batchId) {
  while (true) {
    const res = await fetch(`https://api.olostep.com/v1/batches/${batchId}`, {
      headers: { Authorization: `Bearer ${process.env.OLOSTEP_API_KEY}` },
    })
    const info = await res.json()
    if (info.status === 'completed') return info
    await new Promise((r) => setTimeout(r, 15000))
  }
}

curl "https://api.olostep.com/v1/batches/batch_abc123" \
  -H "Authorization: Bearer $OLOSTEP_API_KEY"

Les SDK Python et Node peuvent attendre pour vous : itérez batch.items() / for await (const item of batch.items()) et ils bloquent jusqu’à ce que le lot soit terminé.

3. Récupérer `json_content`

Listez les éléments, puis récupérez le JSON pour chaque retrieve_id. La charge utile GEO est l’objet analysé à l’intérieur de json_content (une chaîne JSON — analysez-la).

import json
import requests

headers = {"Authorization": f"Bearer {API_KEY}"}

items = requests.get(
    f"https://api.olostep.com/v1/batches/{batch_id}/items",
    headers=headers,
).json()["items"]

for item in items:
    payload = requests.get(
        "https://api.olostep.com/v1/retrieve",
        headers=headers,
        params={"retrieve_id": item["retrieve_id"], "formats": "json"},
    ).json()
    data = json.loads(payload["json_content"])
    print(item["custom_id"], data.get("prompt"), len(data.get("sources") or []))

const itemsRes = await fetch(
  `https://api.olostep.com/v1/batches/${batchId}/items`,
  { headers: { Authorization: `Bearer ${process.env.OLOSTEP_API_KEY}` } }
)
const { items } = await itemsRes.json()

for (const item of items) {
  const params = new URLSearchParams({
    retrieve_id: item.retrieve_id,
    formats: 'json',
  })
  const payload = await fetch(
    `https://api.olostep.com/v1/retrieve?${params}`,
    { headers: { Authorization: `Bearer ${process.env.OLOSTEP_API_KEY}` } }
  ).then((r) => r.json())

  const data = JSON.parse(payload.json_content)
  console.log(item.custom_id, data.prompt, (data.sources || []).length)
}

for item in batch.items():
    content = item.retrieve(["json"])
    print(item.custom_id, content.json_content)

Les éléments échoués sont listés séparément — passez status=failed sur GET /v1/batches/{batch_id}/items. Le JSON hébergé est également disponible à json_hosted_url sur la charge utile de récupération pendant environ 7 jours.

Ce que vous obtenez

Chaque parseur renvoie answer_markdown. La plupart renvoient également prompt. Le reste est spécifique au moteur. Les aperçus compacts ci-dessous proviennent de lots en direct country=US.

Les moteurs listés ici sont les parseurs GEO publics. Nous prenons également en charge des parseurs et connecteurs supplémentaires en interne, ainsi que des parseurs personnalisés pour des sites spécifiques — nous les partageons sur demande. Envoyez un email à info@olostep.com ou contactez-nous sur Slack.

Les citations sont dans sources (cited: true lorsqu’elles sont référencées en ligne). Les sections structurées sont dans text_blocks (text, heading, list, table). Les cartes sponsorisées sont dans ads lorsque Google les affiche — une requête en direct sur les écouteurs a renvoyé des sources et un tableau comparatif mais a omis ads. Les champs vides sont supprimés, non renvoyés comme [].

{
  "answer_markdown": "When looking for the best wireless over-ear or on-ear headphones under $200...",
  "sources": [
    {
      "url": "https://www.reddit.com/r/HeadphoneAdvice/comments/173hvu2/best_wireless_headphones_for_under_200_dollars/",
      "title": "Best wireless headphones for under 200 dollars : r/HeadphoneAdvice",
      "description": "According to a Reddit user, the Sennheiser Accentum headphones are a good option...",
      "domain": "https://www.reddit.com",
      "cited": false
    }
  ],
  "text_blocks": [
    { "type": "text", "snippet": "When looking for the best wireless over-ear or on-ear headphones under $200..." },
    {
      "type": "table",
      "snippet": "Model | Best For | Key Features | Price Range",
      "data": {
        "headers": ["Model", "Best For", "Key Features", "Price Range"],
        "rows": [
          ["Anker Soundcore Space Q45", "Overall Value & ANC", "Strong adaptive ANC, 50-hour battery life", "~$100 - $150"]
        ]
      }
    }
  ]
}

Les puces en ligne sont inline_references. Le tiroir des sources est sources. Les achats sont products. Les blocs de marque sponsorisés sont ads (brand + cards). Les modules vides sont []. network_search_calls est la trace de la recherche web.

{
  "url": "https://chatgpt.com/?q=best%20wireless%20headphones%20under%20%24200",
  "prompt": "best wireless headphones under $200",
  "answer_markdown": "If you mean **over-ear wireless headphones with ANC**...",
  "inline_references": [
    {
      "url": "https://www.rtings.com/headphones/reviews/best/by-price/under-200",
      "text": "The 5 Best Headphones Under $200 of 2026 - RTINGS.com",
      "position": 1
    }
  ],
  "sources": [
    {
      "url": "https://www.tomsguide.com/us/best-headphones-deals,news-28645.html",
      "title": "Best headphone deals for August 2026",
      "snippet": "This August 2026 headphone deal roundup...",
      "cited": false,
      "date_published": "2026-08-19T16:18:38.000Z",
      "attribution": "www.tomsguide.com"
    }
  ],
  "ads": [
    {
      "brand": { "name": "Razer", "url": "https://www.razer.com/" },
      "cards": [
        {
          "title": "Razer BlackShark V3 Pro",
          "body": "Pros swear by its unrivaled clarity...",
          "url": "https://www.razer.com/gaming-headsets/razer-blackshark-v3-pro?utm_source=chatgpt&...",
          "image": "https://bzrcdn.openai.com/fe8bef58c7129858.jpg"
        }
      ]
    }
  ],
  "products": [
    {
      "title": "Soundcore Space Q45",
      "price": 139.99,
      "currency": "$",
      "vendors": [
        {
          "price": 139.99,
          "currency": "$",
          "website": "Best Buy",
          "link": "https://www.bestbuy.com/product/soundcore-by-anker-space-q45-...?utm_source=chatgpt.com"
        }
      ]
    }
  ],
  "locations": [],
  "web_searched": true,
  "network_search_calls": {
    "search_triggered": true,
    "model_slug": "auto",
    "search_queries": [
      { "query": "best wireless headphones under $200 2026 Sony WH-CH720N Soundcore Space Q45...", "type": "model_query" }
    ]
  }
}

shopping_cards, videos, images, hotels, et places sont des tableaux vides lorsque ce module n’a pas été affiché. search_model_queries est ce que Perplexity a réellement recherché.

{
  "url": "https://www.perplexity.ai/search/53051455-01ac-48a2-8aa7-45e518588af0",
  "prompt": "best wireless headphones under $200",
  "answer_markdown": "*   Anker Soundcore Space Q45 Wireless...",
  "sources": [
    {
      "position": 1,
      "label": "The 5 Best Headphones Under $200 of 2026",
      "url": "https://www.rtings.com/headphones/reviews/best/by-price/under-200",
      "description": "",
      "domain": "www.rtings.com",
      "date": ""
    }
  ],
  "related_queries": [
    "best budget wireless headphones under 200 dollars for sound quality"
  ],
  "shopping_cards": [],
  "videos": [],
  "images": [],
  "hotels": [],
  "places": [],
  "search_model_queries": [
    { "query": "best wireless headphones under $200", "engine": "web", "limit": 8 }
  ],
  "model": "perplexity",
  "web_searched": true
}

text_blocks est l’aperçu divisé en paragraphes et listes. sources sont les citations AIO. organic_results est le SERP classique en dessous, lorsqu’il est présent.

{
  "url": "https://www.google.com/search?q=what+is+mitochondria&gl=us",
  "prompt": "what is mitochondria",
  "answer_markdown": "mitochondria\n\nMitochondria are membrane-bound organelles...",
  "sources": [
    {
      "title": "The Mitochondria",
      "url": "https://www.youtube.com/watch?v=sl6RXHnAMVs&t=7",
      "source": "YouTube",
      "index": 1
    }
  ],
  "text_blocks": [
    { "type": "paragraph", "snippet": "mitochondria\n\nMitochondria are membrane-bound organelles..." }
  ],
  "organic_results": [
    {
      "position": 1,
      "title": "Mitochondria",
      "link": "https://www.genome.gov/genetics-glossary/Mitochondria",
      "snippet": "Mitochondria are membrane-bound cell organelles..."
    }
  ]
}

{
  "url": "https://gemini.google.com/app/d11cddf049763b9b",
  "prompt": "best wireless headphones under $200",
  "answer_markdown": "Finding great wireless headphones under $200...",
  "sources": [
    {
      "position": 1,
      "label": "Best Noise Cancelling Headphones under $200 (50+ Tested!)",
      "url": "https://recordingnow.com/blog/best-budget-wireless-headphones/",
      "description": "The Sony WH-CH720N is the LIGHTEST full-sized...",
      "confidence_level": 9
    }
  ],
  "links_attached": true,
  "model": "gemini"
}

sources[].position est un décalage de caractère dans answer_markdown, pas un rang. cited indique si la source est attachée dans la réponse.

{
  "url": "https://copilot.microsoft.com/chats?q=best%20wireless%20headphones%20under%20%24200",
  "prompt": "best wireless headphones under $200",
  "answer_markdown": "**The best wireless headphones under $200 in 2026 are the Sony WH-CH720N...",
  "sources": [
    {
      "url": "https://progressiveradionetwork.com/best-wireless-headphones-under-200-dollars/",
      "title": "10 Best Wireless Headphones Under 200$ (August 2026) Tested",
      "position": 1124,
      "icon_url": "https://services.bingapis.com/favicon?url=progressiveradionetwork.com",
      "cited": true
    }
  ]
}

Exemples

Suivre les moteurs de recherche AI

Moteurs

Tarification

1. Créer le lot

2. Attendre la complétion

3. Récupérer `json_content`

Ce que vous obtenez

Connexes

​Moteurs

​Tarification

​1. Créer le lot

​2. Attendre la complétion

​3. Récupérer json_content

​Ce que vous obtenez

​Connexes

Moteurs

Tarification

1. Créer le lot

2. Attendre la complétion

3. Récupérer `json_content`

Ce que vous obtenez

Connexes