# Cascada de la API OnPage

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/on_page/waterfall`

**Tags:** DataForSEO

La línea de tiempo de carga de una `url` rastreada: qué se solicitó, en qué orden y cuánto tardó cada elemento. Lee un rastreo finalizado, así que necesita el `id` de `post_dataforseo_on_page_submit` y devuelve `crawl_progress` más un `crawl_status` con `max_crawl_pages`, `pages_in_queue` y `pages_crawled`: comprueba esos valores antes de fiarte de un resultado pequeño, porque un rastreo aún en curso simplemente tiene menos que informar. Úsala para explicar una página lenta; para una auditoría de rendimiento con puntuación, usa `post_dataforseo_on_page_lighthouse_live_json`. 💰 Gratis en el upstream: consultar un rastreo finalizado no cuesta nada; solo cuesta el rastreo en sí.

### Referencia de precios

- Medición: Costo de respuesta reportado.
- Estimación de referencia por solicitud: USD 0.012.
- 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.

## Related links

- [Task POST](<https://docs.dataforseo.com/v3/on_page/task_post/>)
- [Time To Interactive (TTI)](<https://web.dev/interactive/>)
- [(TTFB)](<https://en.wikipedia.org/wiki/Time_to_first_byte>)

## 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: **no**

### application/json

Schema:

```json
{
  "type": "array",
  "items": {
    "type": [
      "object",
      "null"
    ],
    "oneOf": [
      {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "<em>ID de la tarea</em><br><strong>campo obligatorio</strong><br>puedes obtener este ID en la respuesta del endpoint Task POST<br>ejemplo:<br>\"07131248-1535-0216-1000-17384017ad04\""
          },
          "url": {
            "type": "string",
            "description": "<em>URL de la página</em><br><strong>campo obligatorio</strong><br>especifica las páginas para las que quieres recibir datos de tiempo"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>identificador de tarea definido por el usuario</em><br>campo opcional<br><em>el límite de caracteres es 255</em><br>puedes usar este parámetro para identificar la tarea y relacionarla con el resultado<br>encontrarás el valor de <code>tag</code> especificado en el objeto <code>data</code> de la respuesta"
          }
        },
        "example": [
          {
            "id": "08101204-0696-0216-0000-644a7b21a48a",
            "url": "https://dataforseo.com/tag/broken-links"
          }
        ]
      }
    ]
  },
  "example": [
    {
      "id": "08101204-0696-0216-0000-644a7b21a48a",
      "url": "https://dataforseo.com/tag/broken-links"
    }
  ]
}
```

## Responses

### 200 — Operación correcta

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

**application/json**

Schema: object | null

```json
{
  "type": [
    "object",
    "null"
  ],
  "oneOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_OnPageWaterfallResponseInfo"
    }
  ]
}
```

### 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
{}
```

## Schema definitions

### Response36Afe1097B20_BaseResponseInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`

```json
{
  "properties": {
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "la versión actual de la API"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "código de estado general\npuedes encontrar la lista completa de los códigos de respuesta aquí"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "mensaje informativo general\npuedes encontrar la lista completa de los mensajes informativos generales aquí"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "tiempo total de ejecución, en segundos"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "costo total de las tareas, USD",
      "format": "double"
    },
    "tasks_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "el número de tareas en el array de tareas",
      "format": "int64"
    },
    "tasks_error": {
      "type": [
        "integer",
        "null"
      ],
      "description": "el número de tareas en el array de tareas devueltas con un error",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseTaskInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`

```json
{
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "identificador de la tarea\nidentificador único de la tarea en nuestro sistema en formato UUID"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "código de estado de la tarea\ngenerado por DataForSEO; puede estar dentro del siguiente intervalo: 10000-60000\npuedes encontrar la lista completa de los códigos de respuesta aquí"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "mensaje informativo de la tarea\npuedes encontrar la lista completa de los mensajes informativos generales aquí"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "tiempo de ejecución, segundos"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "costo total de las tareas, USD",
      "format": "double"
    },
    "result_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "número de elementos en el array de resultados",
      "format": "int64"
    },
    "path": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "ruta de la URL"
    },
    "data": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ]
      },
      "description": "contiene los mismos parámetros que especificaste en la solicitud POST"
    }
  }
}
```

### Response36Afe1097B20_CrawlStatusInfo

`#/components/schemas/Response36Afe1097B20_CrawlStatusInfo`

```json
{
  "type": "object",
  "properties": {
    "max_crawl_pages": {
      "type": [
        "integer",
        "null"
      ],
      "description": "número máximo de páginas que se pueden rastrear\nindica el límite max_crawl_pages que especificaste al configurar una tarea",
      "format": "int64"
    },
    "pages_in_queue": {
      "type": [
        "integer",
        "null"
      ],
      "description": "número de páginas que están actualmente en la cola de rastreo",
      "format": "int64"
    },
    "pages_crawled": {
      "type": [
        "integer",
        "null"
      ],
      "description": "número de páginas rastreadas",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_OnPageResourceLocationInfo

`#/components/schemas/Response36Afe1097B20_OnPageResourceLocationInfo`

```json
{
  "type": "object",
  "properties": {
    "line": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>número de línea</em><br>el número de la línea en la que se encuentra el recurso"
    },
    "offset_left": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>posición en la línea</em><br>el número de caracteres de la línea anteriores al recurso;<br>a veces se denomina <em>columna</em><br><strong>Nota:</strong> cuenta desde 1, es decir, si el recurso no tiene ningún carácter a la izquierda, el valor será 1"
    },
    "offset_top": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>posición en el documento</em><br>el número total de caracteres entre el recurso y el inicio del HTML"
    }
  }
}
```

### Response36Afe1097B20_OnPageWaterfallItem

`#/components/schemas/Response36Afe1097B20_OnPageWaterfallItem`

```json
{
  "type": "object",
  "properties": {
    "page_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>URL de la página</em>"
    },
    "time_to_interactive": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>métrica Time To Interactive (TTI)</em><br>el tiempo que transcurre hasta que el usuario puede interactuar con una página (en milisegundos)"
    },
    "dom_complete": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>tiempo para cargar recursos</em><br>el tiempo que transcurre hasta que se descargan la página y todos sus subrecursos (en milisegundos)"
    },
    "connection_time": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>tiempo para conectar con un servidor</em><br>el tiempo que transcurre hasta que se establece la conexión con un servidor (en milisegundos)"
    },
    "time_to_secure_connection": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>tiempo para establecer una conexión segura</em><br>el tiempo que transcurre hasta que se establece la conexión segura con un servidor (en milisegundos)"
    },
    "request_sent_time": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>tiempo para enviar una solicitud a un servidor</em><br>el tiempo que transcurre hasta que se envía la solicitud a un servidor (en milisegundos)"
    },
    "waiting_time": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>tiempo hasta el primer byte (TTFB) en milisegundos</em>"
    },
    "download_time": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>tiempo que tarda un navegador en recibir una respuesta (en milisegundos)</em>"
    },
    "duration_time": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>tiempo total que tarda un navegador en recibir una respuesta completa de un servidor (en milisegundos)</em>"
    },
    "fetch_start": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>tiempo para iniciar la descarga del recurso HTML</em><br>el tiempo que necesita el navegador para empezar a descargar una página"
    },
    "fetch_end": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>tiempo para completar la descarga del recurso HTML</em><br>el tiempo que necesita el navegador para completar la descarga de una página"
    },
    "resources": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_WaterfallResourceInfo"
          }
        ]
      },
      "description": "<em>tiempos específicos de cada recurso</em><br>contiene arrays separados con los tiempos de cada recurso encontrado en la página"
    }
  }
}
```

### Response36Afe1097B20_OnPageWaterfallResponseInfo

`#/components/schemas/Response36Afe1097B20_OnPageWaterfallResponseInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo"
    },
    {
      "type": "object",
      "properties": {
        "tasks": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_OnPageWaterfallTaskInfo"
              }
            ]
          },
          "description": "<em>array de tareas</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_OnPageWaterfallResultInfo

`#/components/schemas/Response36Afe1097B20_OnPageWaterfallResultInfo`

```json
{
  "type": "object",
  "properties": {
    "crawl_progress": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>estado de la sesión de rastreo</em><br>valores posibles: <code>in_progress</code>, <code>finished</code>"
    },
    "crawl_status": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_CrawlStatusInfo"
        }
      ],
      "description": "<em>detalles de la sesión de rastreo</em>"
    },
    "items_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>número de elementos del array de resultados</em>",
      "format": "int64"
    },
    "items": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_OnPageWaterfallItem"
          }
        ]
      },
      "description": "<em>array items</em>"
    }
  }
}
```

### Response36Afe1097B20_OnPageWaterfallTaskInfo

`#/components/schemas/Response36Afe1097B20_OnPageWaterfallTaskInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
    },
    {
      "type": "object",
      "properties": {
        "result": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_OnPageWaterfallResultInfo"
              }
            ]
          },
          "description": "<em>array de resultados</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_WaterfallResourceInfo

`#/components/schemas/Response36Afe1097B20_WaterfallResourceInfo`

```json
{
  "type": "object",
  "properties": {
    "resource_type": {
      "type": [
        "string",
        "null"
      ]
    },
    "url": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>URL del recurso</em>"
    },
    "initiator": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>iniciador del recurso</em>"
    },
    "duration_time": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>tiempo total que tarda un navegador en recibir una respuesta completa de un servidor (en milisegundos)</em>"
    },
    "fetch_start": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>tiempo para iniciar la descarga del recurso HTML</em><br>el tiempo que necesita el navegador para empezar a descargar una página"
    },
    "fetch_end": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>tiempo para completar la descarga del recurso HTML</em><br>el tiempo que necesita el navegador para completar la descarga de una página"
    },
    "location": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_OnPageResourceLocationInfo"
        }
      ],
      "description": "<em>ubicación del recurso en el documento</em><br>parámetros que definen la ubicación del recurso específico dentro del HTML del documento"
    },
    "is_render_blocking": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "<em>indica si el recurso bloquea el renderizado</em>"
    }
  }
}
```
