데이터 API / Similarweb / Search

Website Keywords

Website Keywords. Response follows the SimilarWeb v5 envelope (meta + data). Date constraint: the start_date-end_date span must cover between 1 and 3 monthly buckets.

파라미터

쿼리

domainstring필수
Target domain, e.g. example.com.
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.
web_sourcestring선택
허용 값: total
Traffic source device split. Allowed: total.
main_domain_onlyboolean선택
Restrict to the main domain only (true/false).
formatstring선택
허용 값: json
Response format. Allowed: json.

요청 예시

curl -G "https://openapi.felo.ai/v1/beta/similarweb/search/website-keywords" \
  --data-urlencode "domain=<string>" \
  --data-urlencode "start_date=<string>" \
  --data-urlencode "end_date=<string>" \
  --data-urlencode "granularity=<string>" \
  --data-urlencode "limit=<integer>" \
  -H "Authorization: Bearer $FELO_API_KEY"

응답

응답 예시

{
  "meta": {
    "query": {
      "limit": 5,
      "offset": 0,
      "asc": null,
      "sort": null
    },
    "request": {
      "branded_type": "all",
      "keywords_filter_rules": [],
      "format": "json",
      "domain": "nike.com",
      "granularity": "monthly",
      "country": "us",
      "start_date": "2026-06-01",
      "end_date": "2026-06-30",
      "traffic_source": "all",
      "web_source": "total",
      "metrics": [
        "clicks",
        "traffic_share",
        "competition",
        "primary_intent",
        "secondary_intent",
        "position",
        "serp_features",
        "top_url",
        "url_count"
      ]
    },
    "status": "success",
    "last_updated": "2026-07-31"
  },
  "data": [
    {
      "keyword": "nike",
      "clicks": 1001887.5658500849,
      "traffic_share": 0.15853772273003125,
      "competition": 100,
      "primary_intent": "Navigational",
      "secondary_intent": null,
      "position": 1,
      "serp_features": [
        "organic_sitelinks",
        "organic_expanded_sitelinks",
        "apps",
        "pla",
        "images",
        "related_searches",
        "popular_products",
        "paid_sitelinks",
        "paid",
        "news",
        "video",
        "organic",
        "local_pack",
        "related_questions"
      ],
      "top_url": "nike.com",
      "url_count": 1581
    }
  ]
}

응답 필드

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[]선택
keywordstring선택
clicksnumber선택
traffic_sharenumber선택
competitioninteger선택
primary_intentstring선택
secondary_intent선택
positioninteger선택
serp_features선택
top_urlstring선택
url_countinteger선택