Descubre qué búsquedas hace Perplexity para responder

Captura la respuesta de Perplexity a cualquier prompt en tu mercado, con sus fuentes numeradas, las búsquedas que hizo y las preguntas de seguimiento que sugiere.

Qué obtienes

• text y markdown: la respuesta completa, en texto plano y con formato.
• sources: las fuentes numeradas detrás de la respuesta, cada una con URL, título y una breve descripción.
• related_queries: las preguntas de seguimiento que Perplexity sugiere a continuación.
• Imágenes, vídeos, lugares, hoteles y tarjetas de producto cuando la respuesta los muestra.

Cómo funciona

Perplexity responde cada pregunta con una búsqueda web, y sus fuentes numeradas muestran exactamente de dónde sale cada afirmación. Cada tarea hace tu pregunta desde el país que indiques y devuelve la respuesta y sus fuentes tal como las ve la gente de ese mercado.

Activa include.searchQueries para recibir también las búsquedas que hizo Perplexity, que revelan cómo divide una pregunta en pasos de investigación.

Para qué sirve

• Descubre en qué dominios se apoya Perplexity en tu categoría y qué lugar ocupan tus páginas entre sus fuentes.
• Convierte las preguntas de seguimiento sugeridas en nuevos prompts para seguir.
• Compara las recomendaciones de Perplexity con las de ChatGPT y Gemini para los mismos 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": "PERPLEXITY",
    "payload": {
      "prompt": "Recommend 3 wireless earbuds for commuting. Compare noise cancellation and battery life in a short table, with sources. Keep it 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.include.markdownboolean

Con true se añade markdown: la respuesta con sus títulos, listas, tablas y enlaces.

payload.include.searchQueriesboolean

Con true se añade searchQueries: las búsquedas web que hizo el motor para escribir la respuesta.

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.

{
  "success": true,
  "task": {
    "id": "67030796-8ecd-4aed-b2c4-6ced6639a313",
    "taskType": "PERPLEXITY",
    "status": "COMPLETED",
    "createdAt": "2026-09-10T02:34:24.023Z"
  },
  "credits": { "creditsToCharge": 1, "creditsCharged": 1 },
  "response": {
    "text": "For commuting, I’d choose **Sony for strongest all-around isolation**, **Bose for maximum ANC comfort**, or **AirPods for Apple integration**.",
    "markdown": "| Earbuds | Noise cancellation | Battery life* | Best for |\n|---|---|---:|---|\n| **Sony WF-1000XM5** | Excellent; measured 32 dB attenuation in key transit-noise frequencies | 8h / 24h case | Android and mixed devices |\n…",
    "sources": [
      {
        "position": 1,
        "url": "https://www.rtings.com/headphones/reviews/best/wireless-earbuds",
        "label": "The 6 Best Wireless Earbuds of 2026 - RTINGS.com",
        "description": "The best wireless earbuds we've tested are the Sony WF-1000XM6. These buds offer top-tier ANC performance."
      },
      {
        "position": 2,
        "url": "https://www.businessinsider.com/guides/tech/best-earbuds",
        "label": "The best earbuds of 2026, tested by audio experts - Business Insider",
        "description": "The best wireless earbuds offer great audio quality in a compact design. These are our top picks from Sony, Bose, Technics, Anker, Apple, and JLab."
      }
    ]
  }
}

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.

response.searchQueriesarray

Las búsquedas web que hizo el motor para escribir la respuesta.

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 Perplexity completada usa 1 crédito.