> 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 a comprobar las estadísticas de uso de Web Scraper API usando solicitudes sencillas. 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` 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 optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.