Naar hoofdinhoud gaan

​
Overzicht

Deze handleiding laat zien hoe je de Batches-eindpunt 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 doorzoeken. 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, controleer op voltooiing om resultaten op te halen.

​
Antwoordformaat

Na het indienen van een batchverzoek en het controleren op voltooiing, ontvang je antwoorden 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, functionarissen 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": "Burgemeester van Austin: Verminderde dakloosheid in de stad is 'een grote zaak'",
      "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": "Oost Austin",
      "icon": null,
      "domain": "https://www.fox7austin.com",
      "cited": true
    },
    ...
  ],
  "country": null
}
Volledige antwoordvoorbeelden:

​
Prijs- en Geolocatiematrix

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

​
Controleren van Ondersteunde Landen

Gebruik het volgende eindpunt 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 maatwerkimplementaties.