Website Analytics
Website traffic, engagement, audience, rankings and search data.
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.
- 類型: stringdomain必填
Target domain, e.g. example.com.
- 類型: stringstart
_date 必填Start month, format YYYY-MM.
- 類型: stringend
_date 必填End month, format YYYY-MM.
- 列舉granularity常數:monthly
Time granularity. Allowed: monthly. Default: monthly.
值- monthly
- 類型: stringmetrics必填
Comma-separated metrics, e.g. visits,pages_per_visit.
- 類型: string 列舉country
Two-letter country code. Allowed: us, ww. Default: ww. Coverage is limited to ww and us on the current plan.
值- us
- ww
- 類型: string 列舉web
_source Traffic source device split. Allowed: desktop, mobile_web, total.
值- desktop
- mobile
_web - total
- 類型: booleanmain
_domain _only Restrict to the main domain only (true/false). Default: True.
- 類型: booleanmtd
Month-to-date flag (true/false).
- 類型: object200
SimilarWeb v5 envelope (meta + data).
- 類型: array object[]data
- average類型: number
_visit _duration - bounce類型: number
_rate - date類型: string
- new類型: number
_users - page類型: number
_views - pages類型: number
_per _visit - returning類型: number
_users - unique類型: number
_visitors - visits類型: number
- 類型: object · SimilarWebMetameta
SimilarWeb v5 response envelope metadata.
- status類型: string必填
Operation status; success for a successful lookup.
- last類型: string
_updated Date of the most recent available data point (YYYY-MM-DD).
- query類型: object
Pagination/sort echo when applicable (limit, offset, asc, sort).
- request類型: object
Normalized request parameters used for this lookup.
application/json - 400
The request could not be processed. Check the request parameters.
- 401
A valid Felo API key is required.
- 402
The request cannot proceed because a billing requirement is not met.
- 403
The account is not permitted to perform this operation.
- 429
A request or spending limit has been reached.
- 502
The service could not complete the request.
- 503
The API or billing service is temporarily unavailable.
- 504
The service timed out while processing the request.
- default
The operation failed. Keep the response request ID when contacting Felo support.
curl 'https://openapi.felo.ai/v1/beta/similarweb/website/traffic-engagement?domain=&start_date=&end_date=&metrics=' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"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
}
]
}