Volg AI-zoekmachines

Gebruik /batches plus een GEO/AEO (Generative Engine Optimization / Answer Engine Optimization) parser om een AI-zoekmachine op schaal te bevragen en gestructureerde JSON terug te krijgen: het antwoord, citaten en commerciële oppervlakken zoals advertenties, winkelkaarten en productmodules. Deze pagina behandelt hoe je /v1/batches aanroept en compacte voorbeelden van de JSON die je terugkrijgt.

Engines

Elke engine heeft zijn eigen parser-ID en URL-sjabloon nodig. Geef de parser één keer door op batchniveau. Codeer de query in de URL.

Engine	Parser	URL-sjabloon	Credits	Max items
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

Alle zes ondersteunen geo-targeting via de batch country parameter (ISO 3166-1 alpha-2). Landendekking verschilt per parser — haal de live lijst op in plaats van deze hard te coderen:

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

Gebruik een informatieve prompt (wat is mitochondria) wanneer je om citaten geeft. Gebruik een commerciële prompt (beste draadloze koptelefoons onder $200) wanneer je advertenties, winkelkaarten of productmodules nodig hebt — die oppervlakken worden intentie-gedetecteerd en weggelaten wanneer de engine ze niet weergeeft.

1. Maak de batch

custom_id moet uniek zijn binnen de batch. country wordt toegepast op elk item.

from olostep import Olostep
from urllib.parse import quote_plus

client = Olostep(api_key="YOUR_API_KEY")

queries = [
    "wat is mitochondria",
    "beste draadloze koptelefoons onder $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 = [
  'wat is mitochondria',
  'beste draadloze koptelefoons onder $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=wat%20is%20mitochondria"
      },
      {
        "custom_id": "aimode-2",
        "url": "https://www.google.com/aimode?q=beste%20draadloze%20koptelefoons%20onder%20%24200"
      }
    ]
  }'

Om een andere engine te targeten, houd je dezelfde items vorm en verwissel je parser.id plus de host in elke URL. Eén batch = één parser.

De verwerkingstijd is ongeveer constant ongeacht de batchgrootte (meestal 5–8 minuten). Geef webhook door bij het aanmaken om batch.completed te krijgen in plaats van te polleren. Nieuwe accounts zijn beperkt tot 100 items per batch — neem contact op met info@olostep.com om dit te verhogen.

2. Wacht op voltooiing

Poll GET /v1/batches/{batch_id} totdat status completed is, of handel de webhook af.

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"

De Python en Node SDK’s kunnen voor je wachten: doorloop batch.items() / for await (const item of batch.items()) en ze blokkeren totdat de batch klaar is.

3. Haal `json_content` op

Lijst items, haal vervolgens JSON op voor elke retrieve_id. De GEO-payload is het geparseerde object binnen json_content (een JSON-string — parseer het).

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)

Mislukte items worden apart vermeld — geef status=failed door bij GET /v1/batches/{batch_id}/items. Gehoste JSON is ook beschikbaar op json_hosted_url in de retrieve payload voor ongeveer 7 dagen.

Wat je terugkrijgt

Elke parser retourneert answer_markdown. De meeste retourneren ook prompt. De rest is engine-specifiek. Compacte voorbeelden hieronder zijn van live country=US batches.

De hier vermelde engines zijn de openbare GEO-parsers. We ondersteunen ook extra parsers en connectors intern, plus aangepaste parsers voor specifieke sites — we delen deze op verzoek. E-mail info@olostep.com of neem contact op via Slack.

Citaten staan in sources (cited: true wanneer inline vermeld). Gestructureerde secties staan in text_blocks (text, heading, list, table). Gesponsorde kaarten staan in ads wanneer Google ze toont — een live koptelefoonquery retourneerde bronnen en een vergelijkingstabel maar liet ads weg. Lege velden worden gestript, niet geretourneerd als [].

{
  "answer_markdown": "Wanneer je op zoek bent naar de beste draadloze over-ear of on-ear koptelefoons onder $200...",
  "sources": [
    {
      "url": "https://www.reddit.com/r/HeadphoneAdvice/comments/173hvu2/best_wireless_headphones_for_under_200_dollars/",
      "title": "Beste draadloze koptelefoons voor minder dan 200 dollar : r/HeadphoneAdvice",
      "description": "Volgens een Reddit-gebruiker zijn de Sennheiser Accentum koptelefoons een goede optie...",
      "domain": "https://www.reddit.com",
      "cited": false
    }
  ],
  "text_blocks": [
    { "type": "text", "snippet": "Wanneer je op zoek bent naar de beste draadloze over-ear of on-ear koptelefoons onder $200..." },
    {
      "type": "table",
      "snippet": "Model | Beste Voor | Belangrijkste Kenmerken | Prijsklasse",
      "data": {
        "headers": ["Model", "Beste Voor", "Belangrijkste Kenmerken", "Prijsklasse"],
        "rows": [
          ["Anker Soundcore Space Q45", "Algemene Waarde & ANC", "Sterke adaptieve ANC, 50-uur batterijduur", "~$100 - $150"]
        ]
      }
    }
  ]
}

Inline chips zijn inline_references. De bronnenlade is sources. Winkelen is products. Gesponsorde merkblokken zijn ads (brand + cards). Lege modules zijn []. network_search_calls is de webzoekopdracht.

{
  "url": "https://chatgpt.com/?q=best%20wireless%20headphones%20under%20%24200",
  "prompt": "beste draadloze koptelefoons onder $200",
  "answer_markdown": "Als je **over-ear draadloze koptelefoons met ANC** bedoelt...",
  "inline_references": [
    {
      "url": "https://www.rtings.com/headphones/reviews/best/by-price/under-200",
      "text": "De 5 Beste Koptelefoons Onder $200 van 2026 - RTINGS.com",
      "position": 1
    }
  ],
  "sources": [
    {
      "url": "https://www.tomsguide.com/us/best-headphones-deals,news-28645.html",
      "title": "Beste koptelefoonaanbiedingen voor augustus 2026",
      "snippet": "Deze augustus 2026 koptelefoonaanbiedingen...",
      "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": "Professionals zweren bij zijn ongeëvenaarde helderheid...",
          "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": "beste draadloze koptelefoons onder $200 2026 Sony WH-CH720N Soundcore Space Q45...", "type": "model_query" }
    ]
  }
}

shopping_cards, videos, images, hotels, en places zijn lege arrays wanneer die module niet werd getoond. search_model_queries is wat Perplexity daadwerkelijk heeft gezocht.

{
  "url": "https://www.perplexity.ai/search/53051455-01ac-48a2-8aa7-45e518588af0",
  "prompt": "beste draadloze koptelefoons onder $200",
  "answer_markdown": "*   Anker Soundcore Space Q45 Draadloos...",
  "sources": [
    {
      "position": 1,
      "label": "De 5 Beste Koptelefoons Onder $200 van 2026",
      "url": "https://www.rtings.com/headphones/reviews/best/by-price/under-200",
      "description": "",
      "domain": "www.rtings.com",
      "date": ""
    }
  ],
  "related_queries": [
    "beste budget draadloze koptelefoons onder 200 dollar voor geluidskwaliteit"
  ],
  "shopping_cards": [],
  "videos": [],
  "images": [],
  "hotels": [],
  "places": [],
  "search_model_queries": [
    { "query": "beste draadloze koptelefoons onder $200", "engine": "web", "limit": 8 }
  ],
  "model": "perplexity",
  "web_searched": true
}

text_blocks is het overzicht opgedeeld in alinea’s en lijsten. sources zijn de AIO-citaties. organic_results is de klassieke SERP eronder, indien aanwezig.

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

{
  "url": "https://gemini.google.com/app/d11cddf049763b9b",
  "prompt": "beste draadloze koptelefoons onder $200",
  "answer_markdown": "Het vinden van geweldige draadloze koptelefoons onder $200...",
  "sources": [
    {
      "position": 1,
      "label": "Beste Noise Cancelling Koptelefoons onder $200 (50+ Getest!)",
      "url": "https://recordingnow.com/blog/best-budget-wireless-headphones/",
      "description": "De Sony WH-CH720N is de LICHTSTE full-sized...",
      "confidence_level": 9
    }
  ],
  "links_attached": true,
  "model": "gemini"
}

sources[].position is een karakteroffset in answer_markdown, geen rang. cited geeft aan of de bron in het antwoord is opgenomen.

{
  "url": "https://copilot.microsoft.com/chats?q=best%20wireless%20headphones%20under%20%24200",
  "prompt": "beste draadloze koptelefoons onder $200",
  "answer_markdown": "**De beste draadloze koptelefoons onder $200 in 2026 zijn de Sony WH-CH720N...",
  "sources": [
    {
      "url": "https://progressiveradionetwork.com/best-wireless-headphones-under-200-dollars/",
      "title": "10 Beste Draadloze Koptelefoons Onder 200$ (Augustus 2026) Getest",
      "position": 1124,
      "icon_url": "https://services.bingapis.com/favicon?url=progressiveradionetwork.com",
      "cited": true
    }
  ]
}

Voorbeelden

Engines

1. Maak de batch

2. Wacht op voltooiing

3. Haal `json_content` op

Wat je terugkrijgt

Gerelateerd

​Engines

​1. Maak de batch

​2. Wacht op voltooiing

​3. Haal json_content op

​Wat je terugkrijgt

​Gerelateerd

Engines

1. Maak de batch

2. Wacht op voltooiing

3. Haal `json_content` op

Wat je terugkrijgt

Gerelateerd