Passer au contenu principal

​
Aperçu

Ce guide montre comment utiliser le point de terminaison Batches d’Olostep pour récupérer des données depuis des outils de recherche AI populaires, y compris Google AI Mode, Gemini, Microsoft Copilot, ChatGPT, Perplexity, et Google AI Overview. En exploitant des analyseurs spécialisés pour chaque plateforme, vous pouvez extraire des résultats de recherche structurés à grande échelle, ce qui est idéal pour :
  • Collecte de renseignements concurrentiels
  • Comparaison des résultats de recherche multi-plateformes
  • Surveillance des moteurs de recherche AI

​
Formulation de la Requête

​
Étape 1 : Préparez vos Requêtes

Créez un tableau de requêtes que vous souhaitez rechercher. Pour cette démonstration, nous allons interroger les actualités dans différentes villes : 
const axios = require('axios');

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

// Démo : Générer des requêtes pour différentes villes
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'
];

​
Étape 2 : Générer des Éléments pour Chaque Outil AI

Chaque outil de recherche AI nécessite un ID d’analyseur spécifique et une structure d’URL. Voici les fonctions de génération d’éléments pour chaque plateforme :
ID d’Analyseur : @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()
    };
  });
};

​
Étape 3 : Soumettre la Requête par Lots

Soumettez votre requête par lots avec les éléments générés : 
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;
Note : Après soumission, sondez pour l’achèvement pour récupérer les résultats.

​
Format de Réponse

Après avoir soumis une requête par lots et sondé pour l’achèvement, vous recevrez des réponses dans le format suivant : 
{
  "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
}
Exemples de réponses complètes :

​
Tarification et Matrice de Géolocalisation

Le tableau suivant décrit le support pour la recherche par pays et les crédits consommés par chaque analyseur.
FonctionnalitéGoogle AI ModeChatGPTPerplexityGoogle AI OverviewGeminiMicrosoft CopilotGrok
Pays Pris en Charge✅✅✅✅✅✅✅
Limite de Taille de Lot2500250025002500250010001000
Crédits3533333

​
Vérification des Pays Pris en Charge

Utilisez le point de terminaison suivant pour récupérer la liste des pays pris en charge pour chaque analyseur : 
GET https://api.olostep.com/v1/countries?service=batches&parser={parser_id}
Exemple de Requête : 
curl "https://api.olostep.com/v1/countries?service=batches&parser=@olostep/perplexity-results"
Il manque quelque chose ? Contactez info@olostep.com pour obtenir de l’aide ou une assistance pour une mise en œuvre personnalisée.