Felo API PlatformFelo API Platform

Data API / Similarweb / Website

Similarweb Top Sites Ranking

Return website rankings for an industry category. category and limit are required. limit must not exceed 20. Supported country values are us and ww; ww is the default. offset controls pagination. The response contains meta and data. Data freshness is reported in meta.last_updated.

Параметры

запрос

  • categorystringОбязательный

    Industry category, e.g. Finance.

  • limitintegerОбязательный

    Maximum number of ranking entries to return. Must not exceed 20.

  • countrystringНеобязательный

    Допустимые значения: us · ww

    Supported country codes: us (United States), ww (worldwide). Default: ww.

  • offsetintegerНеобязательный

    Row offset for pagination.

Пример запроса

curl -G "https://openapi.felo.ai/v1/beta/similarweb/website/top-sites-ranking" \
  --data-urlencode "category=<string>" \
  --data-urlencode "limit=<integer>" \
  -H "Authorization: Bearer $FELO_API_KEY"

Ответ

Пример ответа

{
  "meta": {
    "query": {
      "limit": 5,
      "offset": 0
    },
    "request": {
      "category": "Finance",
      "country": "us"
    },
    "status": "success",
    "last_updated": "2026-09-01"
  },
  "data": [
    {
      "domain": "example.com",
      "rank": 1
    }
  ]
}

Поля ответа

  • 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[]Необязательный
  • domainstringНеобязательный
  • rankintegerНеобязательный