# Agregador de resultados

El **Agregador de resultados** te permite recopilar múltiples resultados pequeños de trabajos separados de scraping o parsing en un único archivo agregado. Esto es especialmente útil cuando ejecutas numerosos trabajos que devuelven muchos archivos pequeños que podrían combinarse en colecciones de salida más grandes o cuando necesitas procesar resultados en archivos por lotes (JSON, JSONL o Gzip).

Las respuestas agregadas pueden entregarse a tu [almacenamiento en la nube](/products/es/web-scraper-api/features/result-processing-and-storage/cloud-storage.md) (Google Cloud Storage, Amazon S3 u otros servicios compatibles con S3).

## Cómo usarlo

{% stepper %}
{% step %}

### Crear un agregador

Primero, define una instancia de agregador con un destino de almacenamiento de entrega y disparadores de entrega.

#### Ejemplo de solicitud

La siguiente solicitud crea un agregador que sube un archivo por lotes cada 1 hora (`programación cron`) o cuando el archivo alcanza 500 MB (`524288000` bytes), lo que ocurra primero.

```bash
curl -X POST https://data.oxylabs.io/v1/aggregators \
-u "USERNAME:PASSWORD" \
-H "Content-Type: application/json" \
-d '{
  "name": "amazon_hourly",
  "storage_type": "s3",
  "storage_url": "s3://my_bucket/batches",
  "max_result_count": 10000,
  "max_size_bytes": 524288000,
  "schedule": "0 */1 * * *"
}'
```

#### Parámetros de la solicitud

| Parámetro                                                   | Descripción                                                                                                                                               | Tipo      |
| ----------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- |
| <mark style="background-color:green;">`name`</mark>         | Identificador único del agregador.                                                                                                                        | `cadena`  |
| <mark style="background-color:green;">`storage_type`</mark> | Proveedor de almacenamiento ( `s3`, `gcs`, o `s3_compatible`).                                                                                            | `cadena`  |
| <mark style="background-color:green;">`storage_url`</mark>  | Ruta del bucket/contenedor de destino.                                                                                                                    | `cadena`  |
| `file_output_type`                                          | Formato de salida (`json`, `jsonl`, `gzip_json`, o `gzip_jsonl`)                                                                                          | `cadena`  |
| `max_size_bytes`                                            | <p>Límite máximo del tamaño del lote en bytes.</p><p>Máx.: <strong>1 GB</strong>.</p>                                                                     | `integer` |
| `schedule`                                                  | <p>Frecuencia de agregación en <strong>expresión cron</strong>. (p. ej., <code>0 \*/1 \* \* \*</code> para cada hora).<br>Máx.: <strong>1 h</strong>.</p> | `cadena`  |
| `max_result_count`                                          | Activa la entrega cuando el recuento de resultados alcanza el límite.                                                                                     | `integer` |
| `callback_url`                                              | URL de tu endpoint de callback. [**Más información**](/products/es/web-scraper-api/integration-methods/push-pull.md#callback)                             | `cadena`  |

&#x20;    – parámetro obligatorio.
{% endstep %}

{% step %}

### Enviar solicitudes al agregador

Una vez creado tu agregador, puedes dirigir trabajos de scraping a él usando el `aggregate_name` parámetro. No necesitas especificar los detalles de almacenamiento en estas solicitudes; el agregador se encarga de la entrega.

#### Ejemplo de solicitud

```bash
curl --user "USERNAME:PASSWORD" \\
'https://data.oxylabs.io/v1/queries' \\
-H "Content-Type: application/json" \
-d '{
    "source": "universal",
    "url": "https://www.example.com",
    "aggregate_name": "amazon_hourly"
}'
```

{% endstep %}

{% step %}

### Obtener información del agregador

Puedes comprobar la configuración y las estadísticas de uso de tu agregador en cualquier momento.

#### Ejemplo de solicitud

```bash
GET https://data.oxylabs.io/v1/aggregators/{name}
```

#### Ejemplo de respuesta

```json
{
    "name": "amazon_hourly",
    "callback_url": "",
    "storage_type": "s3",
    "storage_url": "s3://my_bucket/path_for_aggregates",
    "max_result_count": 1048576,
    "max_size_bytes": 524288000,
    "schedule": "0 */1 * * *",
    "file_output_type": "jsonl",
    "filename_prefix": "",
    "filename_suffix": "",
    "created_at": "2025-12-05T13:30:32Z",
    "usage_statistics": {
        "total_result_count": 0,
        "total_bytes_delivered": 0,
        "total_files_delivered": 0
    }
}
```

{% endstep %}
{% endstepper %}

## Entrega y salida

### Entrega automática

Un archivo por lotes se cierra y se sube cuando ocurre cualquiera de las siguientes situaciones:

* El `schedule` se alcanza el límite de tiempo (Máx.: 1 hora).
* El `max_size_bytes` se alcanza el límite de tamaño (Máx.: 1 GB).
* El `max_result_count` se alcanza el límite de resultados.

### Entrega manual

Puedes forzar una entrega inmediata del lote actual antes de que se alcancen los límites usando el `POST https://data.oxylabs.io/v1/aggregators/{name}/trigger` endpoint como en el ejemplo siguiente:

```bash
curl -X POST https://data.oxylabs.io/v1/aggregators/amazon_hourly/trigger -u "USERNAME:PASSWORD"
```

### Estructura de salida

Los archivos de salida por lotes se guardan en tu almacenamiento con marcas de tiempo únicas:

```
my_bucket/
├── batches/
│   ├── 2024-08-08T01:00:00.000-00:00-amazon_hourly.jsonl
│   ├── 2024-08-08T02:00:00.000-00:00-amazon_hourly.jsonl
│   └── 2024-08-08T03:00:00.000-00:00-amazon_hourly.jsonl
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developers.oxylabs.io/products/es/web-scraper-api/features/result-processing-and-storage/result-aggregator.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.