For the complete documentation index, see llms.txt. This page is also available as Markdown.

Estadísticas de uso

Aprende a comprobar las estadísticas 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.

curl --user "user:pass1" 'https://data.oxylabs.io/v2/stats?group_by=month'
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())
<?php

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, "https://data.oxylabs.io/v2/stats");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_USERPWD, "user" . ":" . "pass1");

$result = curl_exec($ch);
echo $result;

if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close ($ch);
?>

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 sección para conocer el significado de cada clave de salida.

Salida de ejemplo

{
    "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.

-

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

¿Te fue útil?