用量统计

总览

您可以以编程方式检查您的用量统计。这些请求免费提供 - 只要您愿意，可经常检查您的用量统计。

端点

查询以下端点找到您的使用量统计数据：

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%20January%2017
date_to	日期上限。最好与 date_from 一起使用。	任何以Y-m-d格式的日期。	https://data.oxylabs.io/v2/stats?date_to=2022%20June%2017
source	让您获得所选单一来source的用量统计。	任何有效的source值。	https://data.oxylabs.io/v2/stats?source=universal_ecommerce
product	让您获得您所选单一产品的用量统计。只有在您使用同一个用户名访问一个以上的Scraper 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

# 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

<?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);
?>

输出

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

数据字典

Key	描述	种类
meta	所有所提交统计数据的容器 查询参数 。	-
data	所有统计数据的容器。	JSON 对象
products	产品级统计对象的列表。.	JSON 数组
all_count	结果的总量。	整数
mode_callback_count	通过推拉整合方法满足的结果数量。	整数
mode_realtime_count	通过实时整合方法满足的结果数量。	整数
mode_superapi_count	通过代理端点整合方法满足的结果数量。	整数
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 对象中的数据是否与解析结果有关。	布林