Zum Hauptinhalt springen

Überblick

Diese Anleitung zeigt, wie du den Batches-Endpunkt von Olostep verwenden kannst, um Daten von beliebten KI-Suchwerkzeugen wie Google AI Mode, Gemini, Microsoft Copilot, ChatGPT, Perplexity und Google AI Overview abzurufen. Durch die Nutzung spezialisierter Parser für jede Plattform kannst du strukturierte Suchergebnisse in großem Maßstab extrahieren, was ideal ist für:
  • Wettbewerbsanalyse
  • Vergleich von Suchergebnissen auf mehreren Plattformen
  • Überwachung von KI-Suchmaschinen

Anfrageformulierung

Schritt 1: Bereite deine Anfragen vor

Erstelle ein Array von Anfragen, die du suchen möchtest. Für dieses Demo werden wir Nachrichten in verschiedenen Städten abfragen:
const axios = require('axios');

// Konfiguration
const CONFIG = {
  url: 'https://api.olostep.com/v1/batches',
  token: 'YOUR_API_KEY_HERE'
};

// Demo: Anfragen für verschiedene Städte generieren
const BASE_QUERY = 'what is the news today in';
const CITIES = [
  'New York', 'Los Angeles', 'Chicago', 'Houston', 'Phoenix',
  'Philadelphia', 'San Antonio', 'San Diego', 'Dallas', 'San Jose'
];

Schritt 2: Erzeuge Items für jedes KI-Werkzeug

Jedes KI-Suchwerkzeug erfordert eine spezifische Parser-ID und URL-Struktur. Unten sind die Funktionen zur Item-Generierung für jede Plattform:
Parser ID: @olostep/google-aimode-results
const generateAIModeItems = () => {
  return CITIES.map((city, index) => {
    const query = `${BASE_QUERY} ${city}`;
    const encodedQuery = encodeURIComponent(query);
    return {
      url: `https://google.com/aimode?q=${encodedQuery}`,
      custom_id: (index + 1).toString()
    };
  });
};

Schritt 3: Sende die Batch-Anfrage

Sende deine Batch-Anfrage mit den generierten Items:
const response = await axios.post(CONFIG.url, {
  parser: { id: '@olostep/gemini-results' },
  items: generateGeminiItems()
}, {
  headers: {
    'Authorization': `Bearer ${CONFIG.token}`,
    'Content-Type': 'application/json'
  }
});

const batchId = response.data.id;
Hinweis: Nach dem Absenden, überwache den Abschluss, um Ergebnisse abzurufen.

Antwortformat

Nach dem Absenden einer Batch-Anfrage und dem Überwachen des Abschlusses erhältst du Antworten im folgenden Format:
{
  "url": "https://www.google.com//search?q=what+is+the+news+today+in+Austin&hl=en&udm=50&aep=11&newwindow=1&sei=mt_oaPvDBrKh5NoPy9W1sQE&mstk=AUtExfANCngr4KIDEH7t1EJsJ3xHfdsjka647_hz7r0UJWh1VM4FhWV9j1f2QOy0ylJU2l9-zWCxfORo5WzWeAN52_oVMM7nGAgEIRdyzsjtT7h1qhBn8Qj2RiN8HFQke6uYjmqnTeR4O1opgHbiLdAe5ZNfkzDyE_9O2zE&csuir=1",
  "prompt": "what is the news today in Austin",
  "answer_markdown": "In Austin news, officials announced that progress has been made on the city's homelessness response \n\n.  \n\n**Top story: Homelessness**  \n\n* Austin officials and local advocates reported \"real, measurable progress\" in addressing the needs of the city's homeless population.\n* The announcement came ahead of a report from the Ending Community Homelessness Coalition (ECHO)... ",
  "sources": [
    {
      "url": "https://www.kxan.com/video/austin-mayor-citys-decreased-homelessness-is-a-big-deal/11151402/#:~:text=Elected%20city%20and%20county%20officials%2C%20along%20with,experiencing%20homelessness%20in%20Austin.%20Read%20More:%20https://www.kxan.com/news/local/austin/echo%2Dto%2Dpresent%2Dreport%2Don%2Dstate%2Dof%2Daustins%2Dhomelessness%2Dresponse%2Dsystem/",
      "title": "KXAN\n·",
      "description": "Austin mayor: City's decreased homelessness is 'a big deal'",
      "icon": null,
      "domain": "https://www.kxan.com",
      "cited": true
    },
    {
      "url": "https://www.fox7austin.com/tag/us/tx/travis-county/austin/east-austin#:~:text=Austin%20pd%20arrests%20man%20in%20deadly%20east%20austin%20double%20shooting",
      "title": "FOX 7 Austin",
      "description": "East Austin",
      "icon": null,
      "domain": "https://www.fox7austin.com",
      "cited": true
    },
    ...
  ],
  "country": null
}
Vollständige Antwortbeispiele:

Preisgestaltung und Geolokalisierungsmatrix

Die folgende Tabelle zeigt die Unterstützung für länderspezifische Suche und die von jedem Parser verbrauchten Credits.
FunktionGoogle AI ModeChatGPTPerplexityGoogle AI OverviewGeminiMicrosoft CopilotGrok
Unterstütztes Land
Batch-Größenlimit2500250025002500250010001000
Credits3533333

Überprüfung unterstützter Länder

Verwende den folgenden Endpunkt, um die Liste der unterstützten Länder für jeden Parser abzurufen:
GET https://api.olostep.com/v1/countries?service=batches&parser={parser_id}
Beispielanfrage:
curl "https://api.olostep.com/v1/countries?service=batches&parser=@olostep/perplexity-results"
Fehlt etwas? Kontaktiere info@olostep.com für Unterstützung oder Hilfe bei der kundenspezifischen Implementierung.