NovedadesNuevo

Cada fuente de Gemini llega con su nivel de confianza

Gemini
Una respuesta de Gemini sobre auriculares inalámbricos junto a su resultado en JSON

Captura lo que responde la app de Gemini a cualquier prompt en tu mercado, con las fuentes web que respaldan la respuesta y un nivel de confianza para cada una.

Qué obtienes

  • text: la respuesta completa de Gemini, con markdown cuando lo pidas.
  • sources: las páginas web en las que Gemini apoya su respuesta, con URL y título.
  • confidence_level en cada fuente: la fuerza con la que Gemini vincula esa fuente a su respuesta, para ponderar las citas.

Cómo funciona

Cada tarea hace tu pregunta a la app de consumo de Gemini desde el país que indiques y devuelve la respuesta que ven allí tus clientes. Gemini combina lo que sabe con lo que encuentra en la web, y la lista de fuentes muestra exactamente qué páginas respaldan la respuesta.

Envía a Gemini los mismos prompts que mandas a ChatGPT y Perplexity para comparar qué marcas recomienda cada motor y en qué páginas confía cada uno.

Para qué sirve

  • Sigue cómo describe Gemini tu marca y a tus competidores.
  • Pondera las citas por confianza para encontrar las fuentes con más peso en tu categoría.
  • Compara Gemini con los demás motores en un mismo conjunto de prompts.

Envía la solicitud

Envía la solicitud con tu clave de API en la cabecera Authorization.

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "GEMINI",
    "payload": {
      "prompt": "Search the web and recommend 3 wireless earbuds for commuting. Compare noise cancellation and battery life in a short table, with source links. Keep the answer under 180 words.",
      "country": "US",
      "include": { "markdown": true }
    }
  }'

Campos de la solicitud

taskTypestringObligatorio
El motor que se ejecuta, como CHATGPT o GOOGLE.
payload.promptstringObligatorio
La pregunta, escrita como la teclea un usuario en el chat. Hasta 100.000 caracteres.
payload.countrystring
Código de país de dos letras del mercado desde el que se pregunta, como US, KR o JP. Por defecto US.
payload.locationstring
Un lugar dentro de country, como una estación, un barrio o una dirección, de hasta 200 caracteres. El motor responde como a un usuario que está allí. Para CHATGPT, GEMINI, GOOGLE, AIMODE y GOOGLE_SERP.
payload.include.markdownboolean
Con true se añade markdown: la respuesta con sus títulos, listas, tablas y enlaces.
webhook.urlstring
Una dirección HTTPS de tu servidor. La tarea terminada se envía allí en cuanto se completa.
idempotencyKeystring
Tu propio ID para la solicitud. Cada clave crea una sola tarea por cuenta, así que un reenvío sigue siendo una sola tarea.

Respuesta

Así llega una tarea terminada, recortada para que se lea mejor.

JSON
{
  "success": true,
  "task": {
    "id": "40b806b8-c057-4003-934e-98ab5fef2cef",
    "taskType": "GEMINI",
    "status": "COMPLETED",
    "createdAt": "2026-09-10T02:34:15.665Z"
  },
  "credits": { "creditsToCharge": 1, "creditsCharged": 1 },
  "response": {
    "markdown": "Here are 3 top wireless earbuds for commuting:\n\n* **[Bose QuietComfort Ultra Wireless Noise Cancelling Earbuds](…)**: The best choice for commuting, offering unmatched noise cancellation to block …\n…",
    "sources": [
      {
        "position": 3,
        "url": "https://google.com/search?q=EarFun+Air+Pro+4+Wireless+In-ear+headphones&…"
      },
      {
        "position": 5,
        "url": "https://google.com/search?q=Anker+Soundcore+Liberty+5+True+Wireless+Bluetooth+Earbuds&…"
      }
    ]
  }
}
task.statusstring
QUEUED, PROCESSING y al final COMPLETED con la respuesta o FAILED con error.
credits.creditsChargedinteger
Créditos cobrados por la tarea terminada. Una tarea fallida cobra 0.
response.textstring
La respuesta en texto plano.
response.markdownstring
La respuesta con su formato: títulos, listas, tablas y enlaces.
response.sourcesarray
Las páginas que cita la respuesta, en el orden del motor, con position, url y label.

Recibe el resultado

La solicitud devuelve la tarea al instante con status QUEUED. Consulta GET /v1/async/task/{id} hasta que status sea COMPLETED o FAILED, o añade webhook.url y la tarea terminada llega a tu servidor con los mismos task, credits y response. Los resultados siguen disponibles 24 horas después de terminar la tarea.

curl https://api.querying.ai/v1/async/task/$TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

Precio

Cada tarea de Gemini completada usa 1 crédito.

Más novedades

Recibe las novedades

Recibe las actualizaciones por correo.

Feed RSS