Reference example
# Fixed reference example. Playground inputs do not update this sample.
curl --request GET \
--url 'https://api.aisa.one/apis/v1/similarweb/search/serp-players-aggregated?country=ww&end_date=2026-09&keywords=example&limit=1&start_date=2026-09' \
--header 'Authorization: Bearer <token>'curl --request GET \
--url https://api.aisa.one/apis/v1/similarweb/search/serp-players-aggregated \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aisa.one/apis/v1/similarweb/search/serp-players-aggregated"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aisa.one/apis/v1/similarweb/search/serp-players-aggregated', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aisa.one/apis/v1/similarweb/search/serp-players-aggregated",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.aisa.one/apis/v1/similarweb/search/serp-players-aggregated"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.aisa.one/apis/v1/similarweb/search/serp-players-aggregated")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/similarweb/search/serp-players-aggregated")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"clicks": 123,
"domain": "<string>",
"serp_features": "<array>",
"site": "<string>",
"top_url": "<string>",
"top_url_position": 123,
"traffic_share": 123
}
],
"meta": {
"status": "success",
"last_updated": "2026-06-30",
"query": {},
"request": {}
}
}关键词与搜索
SERP Players - Aggregated
<!-- aisa-pricing:start -->
按用量计费；默认请求预估费用：$0.075 USD（不是固定价格）。 声明的单位费率：每 similarweb_credit $0.075 USD。 最终费用以账户适用价格及实际结算为准。
<!-- aisa-pricing:end -->
GET
https://api.aisa.one
/
apis
/
v1
/
similarweb
/
search
/
serp-players-aggregated
Reference example
# Fixed reference example. Playground inputs do not update this sample.
curl --request GET \
--url 'https://api.aisa.one/apis/v1/similarweb/search/serp-players-aggregated?country=ww&end_date=2026-09&keywords=example&limit=1&start_date=2026-09' \
--header 'Authorization: Bearer <token>'curl --request GET \
--url https://api.aisa.one/apis/v1/similarweb/search/serp-players-aggregated \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aisa.one/apis/v1/similarweb/search/serp-players-aggregated"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aisa.one/apis/v1/similarweb/search/serp-players-aggregated', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aisa.one/apis/v1/similarweb/search/serp-players-aggregated",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.aisa.one/apis/v1/similarweb/search/serp-players-aggregated"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.aisa.one/apis/v1/similarweb/search/serp-players-aggregated")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/similarweb/search/serp-players-aggregated")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"clicks": 123,
"domain": "<string>",
"serp_features": "<array>",
"site": "<string>",
"top_url": "<string>",
"top_url_position": 123,
"traffic_share": 123
}
],
"meta": {
"status": "success",
"last_updated": "2026-06-30",
"query": {},
"request": {}
}
}请求规范
- 方法与路径: GET /apis/v1/similarweb/search/serp-players-aggregated
- 可用状态: enabled
- 请求 URL 模板: https://api.aisa.one/apis/v1/similarweb/search/serp-players-aggregated
- country: query; 可选
- end_date: query; 必填
- granularity: query; 可选
- keywords: query; 必填
- limit: query; 必填
- offset: query; 可选
- start_date: query; 必填
- Runtime 事实版本: 472d1bfda50ffcb36fea4b8745e9822da1d9f0225a1e0e220b661005b2d4b7b2
{
"operationId": "get_similarweb_serp_players_aggregated",
"method": "GET",
"path": "/apis/v1/similarweb/search/serp-players-aggregated",
"servers": [
{
"url": "https://api.aisa.one"
}
],
"parameters": [
{
"examples": {
"default": {
"value": "ww"
}
},
"in": "query",
"name": "country",
"required": false,
"schema": {
"default": "ww",
"description": "Worldwide data only; values are case-insensitive.",
"enum": [
"ww"
],
"type": "string"
}
},
{
"examples": {
"default": {
"value": "2026-09"
},
"minimal": {
"value": "2026-09"
}
},
"in": "query",
"name": "end_date",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "granularity",
"required": false,
"schema": {
"enum": [
"monthly"
],
"type": "string"
}
},
{
"examples": {
"default": {
"value": "example"
},
"minimal": {
"value": "example"
}
},
"in": "query",
"name": "keywords",
"required": true,
"schema": {
"type": "string",
"x-aisa-delimiter": ",",
"x-aisa-maxItems": 1,
"x-aisa-minItems": 1
}
},
{
"examples": {
"default": {
"value": 1
},
"minimal": {
"value": 1
}
},
"in": "query",
"name": "limit",
"required": true,
"schema": {
"maximum": 20,
"minimum": 1,
"type": "integer"
}
},
{
"in": "query",
"name": "offset",
"required": false,
"schema": {
"maximum": 100000,
"minimum": 0,
"type": "integer"
}
},
{
"examples": {
"default": {
"value": "2026-09"
},
"minimal": {
"value": "2026-09"
}
},
"in": "query",
"name": "start_date",
"required": true,
"schema": {
"type": "string"
}
}
],
"security": [
{
"bearerAuth": []
}
],
"x-aisa-status": "enabled",
"x-aisa-pricing": {
"cost_contract": "response_count",
"customer_multiplier": 1.0,
"customer_pricing": "provider_cost_multiplier",
"default_request_estimate_usd": 0.075,
"estimate_source": "profile_seed",
"evidence_source": "response_body",
"maximum_units": 20,
"reserve_plan_units": {
"input": "limit",
"input_multiplier": 70000,
"unit_rounding": "ceil",
"unit_scale": 1000000
},
"unit": "similarweb_credit",
"unit_rate_usd": 0.075,
"unit_rounding": "ceil",
"units_per_count": 70000
},
"components": {
"securitySchemes": {
"bearerAuth": {
"scheme": "bearer",
"type": "http"
}
}
}
}
费用与请求规则
按用量计费；默认请求预估费用：$0.075 USD（不是固定价格）。 声明的单位费率：每 similarweb_credit $0.075 USD。 最终费用以账户适用价格及实际结算为准。 公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口，执行前请针对完整请求获取免费报价；执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。- 默认请求参考估价（USD）: 0.075
- 声明的单位费率（USD）: 0.075
- 计费单位: similarweb_credit
- 计费依据: response_count
- 公开参考倍率: 1.0
- 缩放前的计数倍率: 70000
- 声明的最大计数或单位数: 20
- 单位取整: ceil
- 结算证据来源: response_body 计数倍率本身不是 credit 单价或 USD 价格。只采用本定义明确声明的缩放和取整规则；完整请求的费用请使用接口支持的报价功能确认。
预留单位（不是结算用量）
请查看完整定义中的声明；此处不推测公式。- 声明的输入倍率: 70000
- 声明的缩放除数: 1000000
- 声明的取整规则: ceil
- 公开请求参数: limit
请求约束与用量说明
- country 仅支持 ww，默认值为 ww；不支持州级筛选。
授权
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
查询参数
Worldwide data only; values are case-insensitive.
可用选项:
ww 可用选项:
monthly 必填范围:
1 <= x <= 20必填范围:
0 <= x <= 100000