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 du /v1/batches aufrufst und zeigt kompakte Einblicke in das JSON, 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 — hole die Live-Liste ab, anstatt sie fest zu kodieren:

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

Verwende eine Informationsanfrage (was ist Mitochondrien), wenn dir Zitate wichtig sind. Verwende eine kommerzielle Anfrage (beste kabellose Kopfhörer unter 200 $), wenn du Anzeigen, Einkaufskarten oder Produktmodule benötigst — diese Oberflächen werden absichtserkannt und weggelassen, wenn die Engine sie nicht rendert.

Preisgestaltung

Dies ist unsere öffentliche Preisgestaltung für Selbstbedienungskunden. Wir bieten bessere Tarife und Mengenrabatte für Unternehmenskunden. Wir bieten auch benutzerdefinierte Konnektoren für spezialisierte Plattformen und LLM-Engines an. Kontaktiere uns per E-Mail oder Slack.

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 anzusprechen, 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 es zu erhöhen.

2. Auf Abschluss warten

Pollen GET /v1/batches/{batch_id} bis status completed ist, oder behandle den 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"

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

Liste die Elemente auf und rufe dann JSON für jede retrieve_id ab. 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. Sende eine E-Mail an info@olostep.com oder kontaktiere uns auf Slack.

Zitate sind in sources (cited: true, wenn sie inline referenziert werden). 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ß jedoch 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 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. Einkaufen 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 Kopfhörer-Angebotszusammenstellung für 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 preiswerte 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+mitochondria&gl=us",
  "prompt": "was ist Mitochondrien",
  "answer_markdown": "mitochondria\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": "mitochondria\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": "Die Sony WH-CH720N ist die 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

Preisgestaltung

1. Erstelle den Batch

2. Auf Abschluss warten

3. `json_content` abrufen

Was du zurückbekommst

Verwandte Themen

​Engines

​Preisgestaltung

​1. Erstelle den Batch

​2. Auf Abschluss warten

​3. json_content abrufen

​Was du zurückbekommst

​Verwandte Themen

Engines

Preisgestaltung

1. Erstelle den Batch

2. Auf Abschluss warten

3. `json_content` abrufen

Was du zurückbekommst

Verwandte Themen