데이터 API / Similarweb / Website

Traffic & Engagement

Traffic & Engagement. Response follows the SimilarWeb v5 envelope (meta + data). Date constraint: the start_date-end_date span must cover between 1 and 120 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. Default: monthly.
metricsstring필수
Comma-separated metrics, e.g. visits,pages_per_visit.
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선택
허용 값: desktop · mobile_web · total
Traffic source device split. Allowed: desktop, mobile_web, total.
main_domain_onlyboolean선택
Restrict to the main domain only (true/false). Default: True.
mtdboolean선택
Month-to-date flag (true/false).

요청 예시

curl -G "https://openapi.felo.ai/v1/beta/similarweb/website/traffic-engagement" \
  --data-urlencode "domain=<string>" \
  --data-urlencode "start_date=<string>" \
  --data-urlencode "end_date=<string>" \
  --data-urlencode "metrics=<string>" \
  -H "Authorization: Bearer $FELO_API_KEY"

응답

응답 예시

{
  "meta": {
    "request": {
      "format": "json",
      "domain": "cnn.com",
      "granularity": "monthly",
      "country": "us",
      "start_date": "2026-06-01",
      "end_date": "2026-06-30",
      "web_source": "total",
      "metrics": [
        "visits",
        "pages_per_visit",
        "average_visit_duration",
        "bounce_rate",
        "new_users",
        "page_views",
        "returning_users",
        "unique_visitors"
      ],
      "state": null,
      "mtd": false,
      "main_domain_only": true
    },
    "status": "success",
    "last_updated": "2026-07-31"
  },
  "data": [
    {
      "date": "2026-06-01",
      "visits": 182538329.78179574,
      "bounce_rate": 0.6402229356798581,
      "average_visit_duration": 194.8333714917004,
      "pages_per_visit": 1.9970684926970637,
      "page_views": 364541547.1167704,
      "unique_visitors": 32705292.619999997,
      "new_users": 10074246.080150243,
      "returning_users": 22631046.540221456
    }
  ]
}

응답 필드

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[]선택
datestring선택
visitsnumber선택
bounce_ratenumber선택
average_visit_durationnumber선택
pages_per_visitnumber선택
page_viewsnumber선택
unique_visitorsnumber선택
new_usersnumber선택
returning_usersnumber선택