Naar hoofdinhoud gaan

​
Overzicht

Deze gids 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 Overzicht. 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 gaan we nieuws opvragen in verschillende steden: 
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**Topverhaal: Dakloosheid**  \n\n* Austin-functionarissen en lokale voorstanders meldden \"echte, meetbare vooruitgang\" bij 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 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.
FunctieGoogle AI ModeChatGPTPerplexityGoogle AI OverzichtGeminiMicrosoft CopilotGrok
Land Ondersteund✅✅✅✅✅✅✅
Batchgrootte 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 aangepaste implementatie-assistentie.