Estadísticas de uso

Aprende cómo comprobar las estadísticas de uso de Web Scraper API usando solicitudes simples.

Puedes consultar tus estadísticas de uso de forma gratuita enviando una solicitud API.

El endpoint a continuación es para consultas de estadísticas de uso :

GET https://data.oxylabs.io/v2/stats

Entrada

Por defecto, la API devolverá estadísticas de uso sin filtrar (de todo el tiempo, todas las fuentes). Si lo deseas, puedes obtener estadísticas agrupadas y/o filtradas.

Puedes combinar dos o más parámetros en la misma consulta, p. ej., agrupar estadísticas por día y filtrar por fuente.

Parámetro	Descripción	Valores válidos	Ejemplo de URL
group_by	Habilita mostrar estadísticas de uso diarias, mensuales o anuales (en lugar de mostrar estadísticas totales)	día, mes, año	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	Te permite obtener estadísticas de uso de una sola source de tu elección.	Cualquier source valor.	https://data.oxylabs.io/v2/stats?source=universal
product Este filtro es para usuarios heredados (cuentas creadas antes del 25 de septiembre de 2024).	Te permite obtener estadísticas de uso de un único producto de tu elección. Solo aplicable si usas el mismo nombre de usuario para acceder a más de una Scraper API.	serp_scraper_api; ecommerce_scraper_api ; web_scraper_api	https://data.oxylabs.io/v2/stats?product=serp_scraper_api

La consulta siguiente devuelve estadísticas mensuales.

cURL

curl --user "user:pass1" 'https://data.oxylabs.io/v2/stats?group_by=month'

Python

PHP

Salida

El 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 resultados HTML y parseados. Consulta la diccionario de datos sección para conocer el significado de cada clave de salida.

Ejemplo de salida

{
    "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_source1",
                        "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.	-
data	El contenedor de todos los datos estadísticos.	JSON object
products	La lista de objetos de estadísticas a nivel de producto.	JSON array
all_count	La cantidad total de resultados.	Integer
mode_callback_count	La cantidad de resultados completados mediante el método de integración Push-Pull.	Integer
mode_realtime_count	La cantidad de resultados completados mediante el método de integración Realtime.	Integer
mode_superapi_count	La cantidad de resultados completados mediante el método de integración Proxy Endpoint.	Integer
contenttype_parsed_count	La cantidad de resultados parseados.	Integer
contenttype_html_count	La cantidad de resultados HTML.	Integer
render_count	La cantidad de resultados completados con ejecución de JavaScript.	Integer
geo_location_count	La cantidad de resultados que se completaron con un geo_location valor de parámetro definido por el usuario.	Integer
average_response_time	El tiempo de respuesta promedio (segundos).	Float
request_traffic	El total request de tráfico (bytes).	Integer
response_traffic	El total response de tráfico (bytes).	Integer
title	Nombre del producto o de la fuente.	String
sources	La lista de fuentes que pertenecen a un producto en particular.	String
parsed	La indicación de si los datos en el objeto JSON corresponden a resultados parseados.	Booleano