Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.olostep.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Vue d’ensemble

Ce guide montre comment utiliser le point de terminaison Batches d’Olostep pour récupérer des données à partir d’outils de recherche AI populaires, y compris Google AI Mode, Gemini, Microsoft Copilot, ChatGPT, Perplexity et Google AI Overview. En utilisant des analyseurs spécialisés pour chaque plateforme, tu peux extraire des résultats de recherche structurés à grande échelle, ce qui est idéal pour :
  • La collecte d’informations concurrentielles
  • La comparaison des résultats de recherche multi-plateformes
  • La surveillance des moteurs de recherche AI

​
Formulation de la requête

​
Étape 1 : Préparer tes requêtes

Crée un tableau de requêtes que tu souhaites rechercher. Pour cette démo, nous allons interroger les nouvelles à travers 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 lot

Soumets ta requête par lot 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, vérifie l’achèvement pour récupérer les résultats.

​
Format de réponse

Après avoir soumis une requête par lot et vérifié l’achèvement, tu recevras 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 spécifique à chaque pays et les crédits consommés par chaque analyseur.
FonctionnalitéGoogle AI ModeChatGPTPerplexityGoogle AI OverviewGeminiMicrosoft CopilotGrok
Pays supporté✅✅✅✅✅✅✅
Limite de taille de lot2500250025002500250010001000
Crédits3533333

​
Vérification des pays supportés

Utilise le point de terminaison suivant pour récupérer la liste des pays supportés 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 ? Contacte info@olostep.com pour obtenir de l’aide ou une assistance pour une implémentation personnalisée.