KI-Suchmaschinen verfolgen

Verwende /batches zusammen mit einem GEO/AEO (Generative Engine Optimization / Answer Engine Optimization) Parser, um eine KI-Suchmaschine in großem Maßstab abzufragen und strukturiertes JSON zurückzubekommen: die Antwort, Zitate und kommerzielle Oberflächen wie Anzeigen, Einkaufskarten und Produktmodule. Diese Seite behandelt, wie man /v1/batches aufruft und kompakte Einblicke in das JSON erhält, das du zurückbekommst.

Engines

Jede Engine benötigt ihre eigene Parser-ID und URL-Vorlage. Übergebe den Parser einmal auf Batch-Ebene. Kodier die Abfrage in der URL.

Engine	Parser	URL-Vorlage	Credits	Max. Elemente
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 sechs unterstützen Geo-Targeting über den Batch-Parameter country (ISO 3166-1 alpha-2). Die Länderabdeckung variiert je nach Parser — hol dir die aktuelle Liste anstatt sie fest zu kodieren:

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

Verwende einen informativen Prompt (was ist Mitochondrien), wenn dir Zitate wichtig sind. Verwende einen kommerziellen Prompt (beste kabellose Kopfhörer unter 200 $), wenn du Anzeigen, Einkaufskarten oder Produktmodule benötigst — diese Oberflächen werden auf Basis der Absicht erkannt und weggelassen, wenn die Engine sie nicht rendert.

1. Erstelle den Batch

custom_id muss innerhalb des Batches eindeutig sein. country wird auf jedes Element angewendet.

from olostep import Olostep
from urllib.parse import quote_plus

client = Olostep(api_key="YOUR_API_KEY")

queries = [
    "was ist Mitochondrien",
    "beste kabellose Kopfhörer unter 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 = [
  'was ist Mitochondrien',
  'beste kabellose Kopfhörer unter 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=was%20ist%20Mitochondrien"
      },
      {
        "custom_id": "aimode-2",
        "url": "https://www.google.com/aimode?q=beste%20kabellose%20Kopfh%C3%B6rer%20unter%20%24200"
      }
    ]
  }'

Um eine andere Engine anzusteuern, behalte die gleiche items-Struktur bei und tausche parser.id sowie den Host in jeder URL aus. Ein Batch = ein Parser.

Die Verarbeitungszeit ist ungefähr konstant, unabhängig von der Batch-Größe (typischerweise 5–8 Minuten). Übergebe webhook bei der Erstellung, um batch.completed zu erhalten, anstatt zu pollen. Neue Konten sind auf 100 Elemente pro Batch begrenzt — kontaktiere info@olostep.com, um dies zu erhöhen.

2. Auf Abschluss warten

Pollen GET /v1/batches/{batch_id}, bis status completed ist, oder den webhook behandeln.

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"

Die Python- und Node-SDKs können für dich warten: Iteriere batch.items() / for await (const item of batch.items()) und sie blockieren, bis der Batch abgeschlossen ist.

3. `json_content` abrufen

Elemente auflisten und dann JSON für jede retrieve_id abrufen. Die GEO-Nutzlast ist das geparste Objekt innerhalb von json_content (ein JSON-String — parse es).

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)

Fehlgeschlagene Elemente werden separat aufgelistet — übergebe status=failed bei GET /v1/batches/{batch_id}/items. Gehostetes JSON ist auch unter json_hosted_url in der Abrufnutzlast für etwa 7 Tage verfügbar.

Was du zurückbekommst

Jeder Parser gibt answer_markdown zurück. Die meisten geben auch prompt zurück. Der Rest ist enginespezifisch. Kompakte Einblicke unten stammen aus Live-Batches mit country=US.

Die hier aufgeführten Engines sind die öffentlichen GEO-Parser. Wir unterstützen auch zusätzliche Parser und Konnektoren intern, sowie benutzerdefinierte Parser für spezifische Seiten — wir teilen diese auf Anfrage. E-Mail an info@olostep.com oder kontaktiere uns auf Slack.

Zitate sind in sources (cited: true, wenn inline referenziert). Strukturierte Abschnitte sind in text_blocks (text, heading, list, table). Gesponserte Karten sind in ads, wenn Google sie anzeigt — eine Live-Kopfhörerabfrage gab Quellen und eine Vergleichstabelle zurück, ließ aber ads weg. Leere Felder werden entfernt, nicht als [] zurückgegeben.

{
  "answer_markdown": "Wenn du nach den besten kabellosen Over-Ear- oder On-Ear-Kopfhörern unter 200 $ suchst...",
  "sources": [
    {
      "url": "https://www.reddit.com/r/HeadphoneAdvice/comments/173hvu2/best_wireless_headphones_for_under_200_dollars/",
      "title": "Beste kabellose Kopfhörer für unter 200 Dollar : r/HeadphoneAdvice",
      "description": "Laut einem Reddit-Nutzer sind die Sennheiser Accentum-Kopfhörer eine gute Option...",
      "domain": "https://www.reddit.com",
      "cited": false
    }
  ],
  "text_blocks": [
    { "type": "text", "snippet": "Wenn du nach den besten kabellosen Over-Ear- oder On-Ear-Kopfhörern unter 200 $ suchst..." },
    {
      "type": "table",
      "snippet": "Modell | Am besten für | Hauptmerkmale | Preisspanne",
      "data": {
        "headers": ["Modell", "Am besten für", "Hauptmerkmale", "Preisspanne"],
        "rows": [
          ["Anker Soundcore Space Q45", "Gesamtwert & ANC", "Starke adaptive ANC, 50-Stunden-Akkulaufzeit", "~$100 - $150"]
        ]
      }
    }
  ]
}

Inline-Chips sind inline_references. Die Quellen-Schublade ist sources. Shopping ist products. Gesponserte Markenblöcke sind ads (brand + cards). Leere Module sind []. network_search_calls ist die Web-Suchverfolgung.

{
  "url": "https://chatgpt.com/?q=best%20wireless%20headphones%20under%20%24200",
  "prompt": "beste kabellose Kopfhörer unter 200 $",
  "answer_markdown": "Wenn du **kabellose Over-Ear-Kopfhörer mit ANC** meinst...",
  "inline_references": [
    {
      "url": "https://www.rtings.com/headphones/reviews/best/by-price/under-200",
      "text": "Die 5 besten Kopfhörer unter 200 $ im Jahr 2026 - RTINGS.com",
      "position": 1
    }
  ],
  "sources": [
    {
      "url": "https://www.tomsguide.com/us/best-headphones-deals,news-28645.html",
      "title": "Beste Kopfhörerangebote für August 2026",
      "snippet": "Diese Zusammenstellung der Kopfhörerangebote im August 2026...",
      "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": "Profis schwören auf seine unvergleichliche Klarheit...",
          "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 kabellose Kopfhörer unter 200 $ 2026 Sony WH-CH720N Soundcore Space Q45...", "type": "model_query" }
    ]
  }
}

shopping_cards, videos, images, hotels und places sind leere Arrays, wenn dieses Modul nicht angezeigt wurde. search_model_queries ist das, was Perplexity tatsächlich gesucht hat.

{
  "url": "https://www.perplexity.ai/search/53051455-01ac-48a2-8aa7-45e518588af0",
  "prompt": "beste kabellose Kopfhörer unter 200 $",
  "answer_markdown": "*   Anker Soundcore Space Q45 Wireless...",
  "sources": [
    {
      "position": 1,
      "label": "Die 5 besten Kopfhörer unter 200 $ im Jahr 2026",
      "url": "https://www.rtings.com/headphones/reviews/best/by-price/under-200",
      "description": "",
      "domain": "www.rtings.com",
      "date": ""
    }
  ],
  "related_queries": [
    "beste günstige kabellose Kopfhörer unter 200 Dollar für Klangqualität"
  ],
  "shopping_cards": [],
  "videos": [],
  "images": [],
  "hotels": [],
  "places": [],
  "search_model_queries": [
    { "query": "beste kabellose Kopfhörer unter 200 $", "engine": "web", "limit": 8 }
  ],
  "model": "perplexity",
  "web_searched": true
}

text_blocks ist die Übersicht, aufgeteilt in Absätze und Listen. sources sind die AIO-Zitate. organic_results ist das klassische SERP darunter, wenn vorhanden.

{
  "url": "https://www.google.com/search?q=was+ist+Mitochondrien&gl=us",
  "prompt": "was ist Mitochondrien",
  "answer_markdown": "Mitochondrien\n\nMitochondrien sind membrangebundene Organellen...",
  "sources": [
    {
      "title": "Die Mitochondrien",
      "url": "https://www.youtube.com/watch?v=sl6RXHnAMVs&t=7",
      "source": "YouTube",
      "index": 1
    }
  ],
  "text_blocks": [
    { "type": "paragraph", "snippet": "Mitochondrien\n\nMitochondrien sind membrangebundene Organellen..." }
  ],
  "organic_results": [
    {
      "position": 1,
      "title": "Mitochondrien",
      "link": "https://www.genome.gov/genetics-glossary/Mitochondria",
      "snippet": "Mitochondrien sind membrangebundene Zellorganellen..."
    }
  ]
}

{
  "url": "https://gemini.google.com/app/d11cddf049763b9b",
  "prompt": "beste kabellose Kopfhörer unter 200 $",
  "answer_markdown": "Großartige kabellose Kopfhörer unter 200 $ zu finden...",
  "sources": [
    {
      "position": 1,
      "label": "Beste Noise-Cancelling-Kopfhörer unter 200 $ (50+ getestet!)",
      "url": "https://recordingnow.com/blog/best-budget-wireless-headphones/",
      "description": "Der Sony WH-CH720N ist der LEICHTESTE vollwertige...",
      "confidence_level": 9
    }
  ],
  "links_attached": true,
  "model": "gemini"
}

sources[].position ist ein Zeichenoffset in answer_markdown, kein Rang. cited gibt an, ob die Quelle in der Antwort angehängt ist.

{
  "url": "https://copilot.microsoft.com/chats?q=best%20wireless%20headphones%20under%20%24200",
  "prompt": "beste kabellose Kopfhörer unter 200 $",
  "answer_markdown": "**Die besten kabellosen Kopfhörer unter 200 $ im Jahr 2026 sind die Sony WH-CH720N...",
  "sources": [
    {
      "url": "https://progressiveradionetwork.com/best-wireless-headphones-under-200-dollars/",
      "title": "10 beste kabellose Kopfhörer unter 200 $ (August 2026) getestet",
      "position": 1124,
      "icon_url": "https://services.bingapis.com/favicon?url=progressiveradionetwork.com",
      "cited": true
    }
  ]
}

Beispiele

KI-Suchmaschinen verfolgen

Engines

1. Erstelle den Batch

2. Auf Abschluss warten

3. `json_content` abrufen

Was du zurückbekommst

Verwandte Themen

​Engines

​1. Erstelle den Batch

​2. Auf Abschluss warten

​3. json_content abrufen

​Was du zurückbekommst

​Verwandte Themen

Engines

1. Erstelle den Batch

2. Auf Abschluss warten

3. `json_content` abrufen

Was du zurückbekommst

Verwandte Themen