# Ejecutar una búsqueda web semántica neuronal.

**API:** Data API

**Endpoint:** `POST /v1/beta/exa/search`

**Tags:** Exa

Busca en la web por significado en lugar de por palabra clave. `query` es obligatorio; restringe con `category`, `includeDomains`, `excludeDomains`, `startPublishedDate`, `endPublishedDate`, y define `numResults`. Devuelve `requestId`, `resolvedSearchType`, `searchTime`, `costDollars` y `results[]` con `id`, `title` y `url`. **`id` es la URL**, y es lo que toma `post_exa_contents`. ⚠️ Los resultados **no incluyen texto de la página** salvo que lo pidas: pasa `contents` o continúa con `post_exa_contents`. Elígelo frente a `searchWeb` cuando la consulta sea una descripción y no palabras clave; elige Tavily cuando quieras el texto en la misma llamada, y `post_exa_answer` cuando quieras una respuesta escrita en lugar de una lista.

### Referencia de precios

- Medición: Costo de respuesta reportado.
- Estimación de referencia por solicitud: USD 0.017.
- Multiplicador de referencia del cliente: 1.0. No lo apliques de nuevo a un importe de cliente ya liquidado.

Solo metadatos de referencia, no una cotización de la cuenta, un precio garantizado ni un límite de gasto. Los créditos de recursos no son créditos de Felo. Los cargos finales se rigen por los registros de facturación de Felo.

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Request body

Required: **yes**

### application/json

Schema:

```json
{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "La consulta de búsqueda en lenguaje natural.",
      "example": "latest evaluation frameworks for AI agents"
    },
    "type": {
      "type": "string",
      "enum": [
        "auto",
        "fast",
        "instant",
        "deep-lite",
        "deep",
        "deep-reasoning"
      ],
      "default": "auto",
      "description": "Modo de búsqueda. auto deja que Exa elija; los modos deep intercambian latencia por una recuperación de mayor calidad."
    },
    "numResults": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 10,
      "description": "Número de resultados que se van a devolver."
    },
    "category": {
      "type": "string",
      "enum": [
        "company",
        "research paper",
        "news",
        "personal site",
        "financial report",
        "people"
      ],
      "description": "Sugerencia opcional sobre el tipo de páginas que se deben priorizar."
    },
    "includeDomains": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Devolver solo resultados de estos dominios."
    },
    "excludeDomains": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Excluir resultados de estos dominios."
    },
    "startPublishedDate": {
      "type": "string",
      "format": "date-time",
      "description": "Devolver solo resultados publicados en esta fecha ISO 8601 o después."
    },
    "endPublishedDate": {
      "type": "string",
      "format": "date-time",
      "description": "Devolver solo resultados publicados en esta fecha ISO 8601 o antes."
    },
    "contents": {
      "type": "object",
      "description": "Opciones de contenido que se devuelven junto con cada resultado.",
      "properties": {
        "text": {
          "type": "boolean",
          "description": "Devolver el texto completo de la página."
        },
        "highlights": {
          "type": "boolean",
          "description": "Devolver fragmentos relevantes resaltados."
        },
        "summary": {
          "type": "boolean",
          "description": "Devolver un resumen de la página generado por IA."
        }
      }
    },
    "outputSchema": {
      "type": "object",
      "description": "JSON Schema usado para sintetizar una salida estructurada a partir de los resultados."
    },
    "systemPrompt": {
      "type": "string",
      "description": "Instrucción que guía cómo se genera la salida estructurada."
    },
    "stream": {
      "default": false,
      "enum": [
        false
      ],
      "type": "boolean"
    }
  },
  "required": [
    "query"
  ]
}
```

## Responses

### 200 — Búsqueda completada correctamente.

Headers:
- `X-Request-Id` (string) — Identificador de la solicitud que se debe incluir al contactar con el soporte de Felo.

**application/json**

Schema: object

```json
{
  "type": "object",
  "properties": {
    "requestId": {
      "type": "string",
      "description": "Identificador de solicitud de Exa."
    },
    "results": {
      "type": "array",
      "description": "Resultados de búsqueda clasificados.",
      "items": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "publishedDate": {
            "type": "string"
          },
          "author": {
            "type": "string"
          },
          "id": {
            "type": "string"
          }
        }
      }
    },
    "output": {
      "description": "Salida estructurada, presente solo cuando se proporcionó outputSchema."
    },
    "costDollars": {
      "description": "Desglose de costos del proveedor por uso de recursos. Solo informativo; no es el cargo al cliente de Felo ni un recibo de facturación de Felo."
    }
  }
}
```

### 400 — No se pudo procesar la solicitud. Comprueba los parámetros de la solicitud.

### 401 — Se requiere una clave de API de Felo válida.

### 402 — La solicitud no puede continuar porque no se cumple un requisito de facturación.

### 403 — La cuenta no tiene permiso para realizar esta operación.

### 429 — Se ha alcanzado un límite de solicitudes o de gasto.

### 502 — El servicio no pudo completar la solicitud.

### 503 — La API o el servicio de facturación no están disponibles temporalmente.

### 504 — El servicio agotó el tiempo de espera al procesar la solicitud.

### default — Respuesta de error; las respuestas de paso del upstream pueden usar formatos del proveedor

**application/json**

Schema:

```json
{}
```
