Naar hoofdinhoud gaan

​
Overzicht

Deze gids laat zien hoe je de Batches-endpoint van Olostep kunt gebruiken om gegevens op te halen van populaire AI-zoekhulpmiddelen, waaronder Google AI Mode, Gemini, Microsoft Copilot, ChatGPT, Perplexity en Google AI Overview. Door gebruik te maken van gespecialiseerde parsers voor elk platform, kun je gestructureerde zoekresultaten op grote schaal extraheren, wat ideaal is voor:
  • Het verzamelen van concurrentie-informatie
  • Vergelijking van zoekresultaten op meerdere platforms
  • Monitoring van AI-zoekmachines

​
Verzoek Formuleren

​
Stap 1: Bereid je Zoekopdrachten Voor

Maak een array van zoekopdrachten die je wilt uitvoeren. Voor deze demo zullen we nieuws in verschillende steden opvragen: 
const axios = require('axios');

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

// Demo: Genereer zoekopdrachten voor verschillende steden
const BASE_QUERY = 'wat is het nieuws vandaag in';
const CITIES = [
  'New York', 'Los Angeles', 'Chicago', 'Houston', 'Phoenix',
  'Philadelphia', 'San Antonio', 'San Diego', 'Dallas', 'San Jose'
];

​
Stap 2: Genereer Items voor Elk AI Hulpmiddel

Elk AI-zoekhulpmiddel vereist een specifieke parser-ID en URL-structuur. Hieronder staan de functies voor het genereren van items voor elk platform:
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()
    };
  });
};

​
Stap 3: Dien het Batchverzoek In

Dien je batchverzoek in met de gegenereerde 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;
Opmerking: Na het indienen, poll voor voltooiing om resultaten op te halen.

​
Responsformaat

Na het indienen van een batchverzoek en het poll voor voltooiing, ontvang je reacties in het volgende formaat: 
{
  "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 nieuws, ambtenaren kondigden aan dat er vooruitgang is geboekt in de reactie van de stad op dakloosheid \n\n.  \n\n**Top verhaal: Dakloosheid**  \n\n* Austin-functionarissen en lokale voorstanders meldden \"echte, meetbare vooruitgang\" in het aanpakken van de behoeften van de dakloze bevolking van de stad.\n* De aankondiging kwam voorafgaand aan een rapport van de 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 burgemeester: De verminderde dakloosheid van de stad is 'een groot probleem'",
      "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
}
Volledige responsvoorbeelden:

​
Prijzen en Geolocatie Matrix

De volgende tabel geeft een overzicht van de ondersteuning voor land-specifieke zoekopdrachten en de credits die door elke parser worden verbruikt.
KenmerkGoogle AI ModeChatGPTPerplexityGoogle AI OverviewGeminiMicrosoft CopilotGrok
Land Ondersteund✅✅✅✅✅✅✅
Batch Grootte Limiet2500250025002500250010001000
Credits3533333

​
Controleren van Ondersteunde Landen

Gebruik het volgende endpoint om de lijst van ondersteunde landen voor elke parser op te halen: 
GET https://api.olostep.com/v1/countries?service=batches&parser={parser_id}
Voorbeeldverzoek: 
curl "https://api.olostep.com/v1/countries?service=batches&parser=@olostep/perplexity-results"
Mis je iets? Neem contact op met info@olostep.com voor ondersteuning of hulp bij een aangepaste implementatie.