> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/products/es/web-scraper-api/usage-and-billing/usage-statistics.md). # Estadísticas de uso Aprende cómo comprobar la estadística de uso de Web Scraper API usando solicitudes simples. Puede consultar sus estadísticas de uso sin costo enviando una solicitud de API. El endpoint a continuación es para consultas de estadísticas de uso: ``` GET https://data.oxylabs.io/v2/stats ``` ### Entrada De forma predeterminada, la API devolverá estadísticas de uso sin filtrar (de todos los tiempos, de todas las fuentes). Si lo desea, puede obtener estadísticas agrupadas y/o filtradas. Puede combinar dos o más parámetros en la misma consulta, por ejemplo, agrupar las estadísticas por día y filtrar por fuente. | Parámetro | Descripción | Valores válidos | Ejemplo de URL | | ------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- | | `group_by` | Permite mostrar estadísticas de uso diarias, mensuales o anuales (en lugar de mostrar las estadísticas totales) | `day`, `month`, `year` | `https://data.oxylabs.io/v2/stats?group_by=day` | | `date_from` | El límite inferior de fecha. Se usa mejor junto con `date_to`. | Cualquier fecha en `Y-m-d` formato. | `https://data.oxylabs.io/v2/stats?date_from=2022-01-17` | | `date_to` | El límite superior de fecha. Se usa mejor junto con `date_from`. | Cualquier fecha en `Y-m-d` formato. | `https://data.oxylabs.io/v2/stats?date_to=2022-06-17` | | `source` | Le permite obtener estadísticas de uso de un solo `source` de su elección. | Cualquier valor válido `source` valor. | `https://data.oxylabs.io/v2/stats?source=universal` | |

product

Este filtro es para usuarios antiguos (cuentas creadas antes del 25 de septiembre de 2024).

| Le permite obtener estadísticas de uso de un solo producto de su elección. Solo aplica si usa el mismo nombre de usuario para acceder a más de un Scraper API. |

serp\_scraper\_api;

ecommerce\_scraper\_api ; web\_scraper\_api

| `https://data.oxylabs.io/v2/stats?product=serp_scraper_api` | La siguiente consulta devuelve estadísticas mensuales. {% tabs %} {% tab title="cURL" %} ```shell curl --user "user:pass1" 'https://data.oxylabs.io/v2/stats?group_by=month' ``` {% endtab %} {% tab title="Python" %} ```python import requests from pprint import pprint # Get response from stats endpoint. response = requests.request( method='GET', url='https://data.oxylabs.io/v2/stats', auth=('user', 'pass1'), ) # Print prettified JSON response to stdout. pprint(response.json()) ``` {% endtab %} {% tab title="PHP" %} ```php ``` {% endtab %} {% endtabs %} ### Salida La `v2/stats` la salida contiene estadísticas de uso, incluidas estadísticas a nivel de producto (E-Commerce Scraper API / SERP Scraper API / Web Scraper API). Las estadísticas a nivel de producto se desglosan en estadísticas a nivel de fuente, que a su vez se desglosan en estadísticas separadas para HTML y resultados parseados. Consulte la [**diccionario de datos**](#data-dictionary) sección para conocer el significado de cada clave de salida. #### Salida de ejemplo ```json { "meta": { "group_by": null, "date_from": null, "date_to": null, "source": null, "product": null }, "data": { "products": [ { "all_count": 5837, "mode_callback_count": 5514, "mode_realtime_count": 315, "mode_superapi_count": 8, "contenttype_parsed_count": 56, "contenttype_html_count": 5781, "render_count": 3, "geo_location_count": 2330, "average_response_time": 88.54, "request_traffic": 4685091, "response_traffic": 602064208, "title": "serp_scraper_api", "sources": [ { "all_count": 5616, "mode_callback_count": 5414, "mode_realtime_count": 194, "mode_superapi_count": 8, "render_count": 0, "geo_location_count": 2190, "average_response_time": 91.59, "request_traffic": 4550507, "response_traffic": 585423946, "title": "serp_source2", "parsed": false }, { "all_count": 1, "mode_callback_count": 0, "mode_realtime_count": 1, "mode_superapi_count": 0, "render_count": 0, "geo_location_count": 1, "average_response_time": 11, "request_traffic": 0, "response_traffic": 0, "title": "serp_source2", "parsed": false } ] } ] } } ``` ### Diccionario de datos | Clave | Descripción | Tipo | | -------------------------- | ------------------------------------------------------------------------------------------------------------- | ------------ | | `meta` | El contenedor de todas las estadísticas enviadas [**parámetros de consulta**](#input). | - | | `data` | El contenedor de todos los datos de estadísticas. | objeto JSON | | `products` | La lista de objetos de estadísticas a nivel de producto. | arreglo JSON | | `all_count` | La cantidad total de resultados. | Entero | | `mode_callback_count` | La cantidad de resultados, resueltos mediante el método de integración Push-Pull. | Entero | | `mode_realtime_count` | La cantidad de resultados, resueltos mediante el método de integración Realtime. | Entero | | `mode_superapi_count` | La cantidad de resultados, resueltos mediante el método de integración Proxy Endpoint. | Entero | | `contenttype_parsed_count` | La cantidad de resultados parseados. | Entero | | `contenttype_html_count` | La cantidad de resultados HTML. | Entero | | `render_count` | La cantidad de resultados, obtenidos con ejecución de JavaScript. | Entero | | `geo_location_count` | La cantidad de resultados que se obtuvieron con un `geo_location` valor de parámetro definido por el usuario. | Entero | | `average_response_time` | El tiempo promedio de respuesta (segundos). | Flotante | | `request_traffic` | El total **solicitud** tráfico (bytes). | Entero | | `response_traffic` | El total **response** tráfico (bytes). | Entero | | `title` | Nombre del producto o de la fuente. | Cadena | | `sources` | La lista de fuentes pertenecientes a un producto específico. | Cadena | | `parsed` | La indicación de si los datos del objeto JSON corresponden a resultados parseados. | Booleano | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://developers.oxylabs.io/products/es/web-scraper-api/usage-and-billing/usage-statistics.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.