使用统计

了解如何使用简单请求检查网页爬虫API的使用统计信息。

你可以通过提交 API 请求免费查看你的使用统计。

下方的端点用于查询使用统计：

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

输入

默认情况下，API 会返回未筛选的（全部时间、所有来源）使用统计。你也可以获取分组和/或筛选后的统计。

你可以在同一个查询中组合两个或更多参数，例如按天分组统计并按来源筛选。

参数	描述	有效值	URL 示例
group_by	启用按日、按月或按年的使用统计显示（而不是显示总统计）	day, month, year	https://data.oxylabs.io/v2/stats?group_by=day
date_from	下限日期边界。最好与 date_to.	任意日期，格式为 Y-m-d 格式。	https://data.oxylabs.io/v2/stats?date_from=2022-01-17
date_to	上限日期边界。最好与 date_from.	任意日期，格式为 Y-m-d 格式。	https://data.oxylabs.io/v2/stats?date_to=2022-06-17
source	可让你获取单个 source 你选择的。	任何有效的 source 值分隔。	https://data.oxylabs.io/v2/stats?source=universal
product 此筛选器适用于旧版用户（在 2024 年 9 月 25 日之前创建的账号）。	可让你获取你选择的单个产品的使用统计。仅在你使用同一用户名访问多个网页爬虫API时适用。	serp_scraper_api; ecommerce_scraper_api ; web_scraper_api	https://data.oxylabs.io/v2/stats?product=serp_scraper_api

以下查询返回按月统计。

cURL

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

Python

import requests
from pprint import pprint

# 从统计端点获取响应。
response = requests.request(
    method='GET',
    url='https://data.oxylabs.io/v2/stats',
    auth=('user', 'pass1'),
)

# 将格式化后的 JSON 响应打印到标准输出。
pprint(response.json())

PHP

<?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 '错误:' . curl_error($ch);
}
curl_close ($ch);
?>

输出

该 v2/stats 输出包含使用统计，包括产品级统计（电商爬虫 API / SERP 爬虫 API / 网页爬虫API）。产品级统计会细分为来源级统计，而来源级统计又进一步细分为 HTML 和解析结果的独立统计。请参见 数据字典 章节，了解每个输出键的含义。

示例输出

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

数据字典

键	描述	类型
meta	所有提交统计的容器 查询参数.	-
data	所有统计数据的容器。	JSON 对象
products	产品级统计对象列表。	JSON 数组
all_count	结果总数。	整数
mode_callback_count	通过 Push-Pull 集成方式完成的结果数量。	整数
mode_realtime_count	通过 Realtime 集成方式完成的结果数量。	整数
mode_superapi_count	通过 Proxy Endpoint 集成方式完成的结果数量。	整数
contenttype_parsed_count	解析结果数量。	整数
contenttype_html_count	HTML 结果数量。	整数
render_count	通过执行 JavaScript 完成的结果数量。	整数
geo_location_count	通过用户定义的 geo_location 参数值完成的结果数量。	整数
average_response_time	平均响应时间（秒）。	浮点数
request_traffic	总 请求 流量（字节）。	整数
response_traffic	总 响应 流量（字节）。	整数
title	产品或来源名称。	字符串
sources	属于某个产品的来源列表。	字符串
parsed	指示 JSON 对象中的数据是否属于解析结果。	布尔值