Website Analytics
Website traffic, engagement, audience, rankings and search data.
SimilarSites
SimilarSites. Response follows the SimilarWeb v5 envelope (meta + data). Date window (upstream SimilarWeb constraint): start_date and end_date must span EXACTLY 3 consecutive months — a 1- or 2-month span is rejected with upstream error 120 ('must span exactly 3 month(s)'). That span must also be SimilarWeb's most recent supported window, which advances forward each month; an older or out-of-range span is rejected with error 101 ('Dates not in range'). In practice, request the three most recent completed months (e.g. if the latest published month is 2026-07, use start_date=2026-05 and end_date=2026-07). To read the exact currently-supported range, call SimilarWeb's /describe endpoint for this API.
- 型: stringdomain必須
Target domain, e.g. example.com.
- 型: stringstart
_date 必須Start month, format YYYY-MM. Must be exactly 2 months before end_date: the window has to span exactly 3 consecutive months within SimilarWeb's latest supported range (see the endpoint description).
- 型: stringend
_date 必須End month, format YYYY-MM. Together with start_date must span exactly 3 consecutive months, and must be the most recent supported month (the window rolls forward monthly; see the endpoint description).
- 列挙値granularity定数:monthly
Time granularity. Allowed: monthly.
値- monthly
- 型: integerlimit最大値:20必須
Number of rows to return; max 20, billed as 20 if exceeded.
- 型: 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).
- 型: integeroffset
Row offset for pagination.
- 型: stringtraffic
_source Traffic-source filter.
- 型: object200
SimilarWeb v5 envelope (meta + data).
- 型: array object[]data
- affinity型: number
- category型: string
- domain型: string
- has型: boolean
_adsense - rank型: integer
Integer numbers.
- 型: 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/similar-sites?domain=&start_date=&end_date=&limit=20' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"meta": {
"query": {
"limit": 5,
"offset": 0,
"asc": null,
"sort": null
},
"request": {
"format": "json",
"domain": "cnn.com",
"granularity": "monthly",
"start_date": "2026-05-01",
"end_date": "2026-07-31",
"metrics": [
"rank",
"affinity",
"has_adsense"
],
"category": null
},
"status": "success",
"last_updated": "2026-07-31"
},
"data": [
{
"domain": "bbc.com",
"category": "News_and_Media",
"rank": 95,
"affinity": 1,
"has_adsense": true
}
]
}