数据 API / Similarweb / Search

SERP Players - Aggregated

SERP Players - Aggregated. Response follows the SimilarWeb v5 envelope (meta + data).

参数

查询

keywordstring必填
Target keyword.
start_datestring必填
Start month, format YYYY-MM.
end_datestring必填
End month, format YYYY-MM.
granularitystring可选
允许值： monthly
Time granularity. Allowed: monthly.
limitinteger必填
Number of rows to return; max 20, billed as 20 if exceeded.
countrystring可选
允许值： us · ww
Two-letter country code. Allowed: us, ww. Default: ww. Coverage is limited to ww and us on the current plan.
offsetinteger可选
Row offset for pagination.

请求示例

curl -G "https://openapi.felo.ai/v1/beta/similarweb/search/serp-players-aggregated" \
  --data-urlencode "keyword=<string>" \
  --data-urlencode "start_date=<string>" \
  --data-urlencode "end_date=<string>" \
  --data-urlencode "limit=<integer>" \
  -H "Authorization: Bearer $FELO_API_KEY"

响应

响应示例

{
  "meta": {
    "query": {
      "limit": 5,
      "offset": 0,
      "asc": null,
      "sort": null
    },
    "request": {
      "format": "json",
      "keyword": "nike",
      "granularity": "monthly",
      "country": "us",
      "start_date": "2026-06-01",
      "end_date": "2026-06-30",
      "traffic_source": "all",
      "web_source": "total",
      "metrics": [
        "clicks",
        "traffic_share",
        "serp_features",
        "top_url",
        "top_url_position"
      ],
      "is_keyword_group": false
    },
    "status": "success",
    "last_updated": "2026-07-31"
  },
  "data": [
    {
      "site": "nike.com",
      "domain": "nike.com",
      "clicks": 995980.9211660791,
      "traffic_share": 0.9220950172205099,
      "serp_features": [
        "pla",
        "paid",
        "paid_sitelinks",
        "organic_expanded_sitelinks",
        "organic_sitelinks",
        "organic"
      ],
      "top_url_position": 1,
      "top_url": "nike.com"
    }
  ]
}

响应字段

metaobject可选
SimilarWeb v5 response envelope metadata.
statusstring必填
Operation status; success for a successful lookup.
last_updatedstring可选
Date of the most recent available data point (YYYY-MM-DD).
requestobject可选
Normalized request parameters used for this lookup.
queryobject可选
Pagination/sort echo when applicable (limit, offset, asc, sort).
dataobject[]可选
sitestring可选
domainstring可选
clicksnumber可选
traffic_sharenumber可选
serp_features可选
top_url_positioninteger可选
top_urlstring可选