Usage Statistics

Learn how to check usage statistic of Web Scraper API using simple requests.

Você pode verificar suas estatísticas de uso gratuitamente enviando uma solicitação de API.

O endpoint abaixo é para consultas de estatísticas de uso:

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

Entrada

Por padrão, a API retornará estatísticas de uso não filtradas (de todo o tempo, todas as fontes). Se desejar, você pode obter estatísticas agrupadas e/ou filtradas.

Você pode combinar dois ou mais parâmetros na mesma consulta, por exemplo, agrupar estatísticas por dia e filtrar por fonte.

Parâmetro	Descrição	Valores válidos	Exemplo de URL
group_by	Habilita a exibição de estatísticas de uso diárias, mensais ou anuais (em vez de mostrar estatísticas totais)	day, month, year	https://data.oxylabs.io/v2/stats?group_by=day
date_from	O limite inferior de data. Melhor usado juntamente com date_to.	Qualquer data em Y-m-d formato.	https://data.oxylabs.io/v2/stats?date_from=2022-01-17
date_to	O limite superior de data. Melhor usado juntamente com date_from.	Qualquer data em Y-m-d formato.	https://data.oxylabs.io/v2/stats?date_to=2022-06-17
source	Permite obter estatísticas de uso de uma única source de sua escolha.	Qualquer source valor válido.	https://data.oxylabs.io/v2/stats?source=universal
product Este filtro é para usuários legados (contas criadas antes de 25 de setembro de 2024).	Permite obter estatísticas de uso de um único produto de sua escolha. Aplicável apenas se você usar o mesmo nome de usuário para acessar mais de um Scraper API.	serp_scraper_api; ecommerce_scraper_api ; web_scraper_api	https://data.oxylabs.io/v2/stats?product=serp_scraper_api

A consulta abaixo retorna estatísticas mensais.

cURL

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

Python

PHP

Saída

O v2/stats a saída contém estatísticas de uso, incluindo estatísticas por produto (E-Commerce Scraper API / SERP Scraper API / Web Scraper API). As estatísticas por produto são subdivididas em estatísticas por fonte, que são ainda divididas em estatísticas separadas para resultados HTML e parseados. Veja o dicionário de dados para descobrir o significado de cada chave de saída.

Exemplo de saída

{
    "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
                    }
                ]
            }
        ]
    }
}

Dicionário de dados

Chave	Descrição	Tipo
meta	O contêiner de todas as estatísticas enviadas parâmetros de consulta.	-
data	O contêiner de todos os dados de estatísticas.	JSON object
products	A lista de objetos de estatísticas no nível de produto.	JSON array
all_count	A quantidade total de resultados.	Integer
mode_callback_count	A quantidade de resultados atendidos via método de integração Push-Pull.	Integer
mode_realtime_count	A quantidade de resultados atendidos via método de integração Realtime.	Integer
mode_superapi_count	A quantidade de resultados atendidos via método de integração Proxy Endpoint.	Integer
contenttype_parsed_count	A quantidade de resultados parseados.	Integer
contenttype_html_count	A quantidade de resultados em HTML.	Integer
render_count	A quantidade de resultados atendidos com execução de JavaScript.	Integer
geo_location_count	A quantidade de resultados que foram atendidos com um valor de parâmetro geo_location definido pelo usuário.	Integer
average_response_time	O tempo médio de resposta (segundos).	Float
request_traffic	O total de tráfego de resposta (bytes).	Integer
response_traffic	O total de tráfego de resposta (bytes).	Integer
title	Nome do produto ou da fonte.	String
sources	A lista de fontes pertencentes a um determinado produto.	String
parsed	A indicação se os dados no objeto JSON se referem a resultados parseados.	Boolean