Saltar al contenido principal

​
Descripción General

Esta guía demuestra cómo usar el endpoint Batches de Olostep para obtener datos de herramientas de búsqueda AI populares, incluyendo Google AI Mode, Gemini, Microsoft Copilot, ChatGPT, Perplexity y Google AI Overview. Al aprovechar los analizadores especializados para cada plataforma, puedes extraer resultados de búsqueda estructurados a gran escala, lo que lo hace ideal para:
  • Recolección de inteligencia competitiva
  • Comparación de resultados de búsqueda en múltiples plataformas
  • Monitoreo de motores de búsqueda AI

​
Formulación de Solicitudes

​
Paso 1: Prepara Tus Consultas

Crea un array de consultas que deseas buscar. Para esta demostración, consultaremos noticias en diferentes ciudades: 
const axios = require('axios');

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

// Demostración: Generar consultas para diferentes ciudades
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'
];

​
Paso 2: Generar Elementos para Cada Herramienta AI

Cada herramienta de búsqueda AI requiere un ID de analizador específico y una estructura de URL. A continuación se presentan las funciones de generación de elementos para cada plataforma:
ID de Analizador: @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()
    };
  });
};

​
Paso 3: Enviar la Solicitud por Lote

Envía tu solicitud por lote con los elementos generados: 
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;
Nota: Después de enviar, consulta para completar para recuperar los resultados.

​
Formato de Respuesta

Después de enviar una solicitud por lote y consultar para completar, recibirás respuestas en el siguiente formato: 
{
  "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
}
Ejemplos completos de respuesta:

​
Matriz de Precios y Geolocalización

La siguiente tabla describe el soporte para búsquedas específicas por país y los créditos consumidos por cada analizador.
CaracterísticaGoogle AI ModeChatGPTPerplexityGoogle AI OverviewGeminiMicrosoft CopilotGrok
País Soportado✅✅✅✅✅✅✅
Límite de Tamaño de Lote2500250025002500250010001000
Créditos3533333

​
Verificación de Países Soportados

Usa el siguiente endpoint para recuperar la lista de países soportados para cada analizador: 
GET https://api.olostep.com/v1/countries?service=batches&parser={parser_id}
Ejemplo de Solicitud: 
curl "https://api.olostep.com/v1/countries?service=batches&parser=@olostep/perplexity-results"
¿Falta algo? Ponte en contacto con info@olostep.com para soporte o asistencia en implementaciones personalizadas.