Felo API PlatformFelo API Platform
Все эндпоинты Similarweb
v0.2.0-beta
OpenAPI 3.1.0

Рейтинг топ-сайтов Similarweb

Сервер:https://openapi.felo.ai
Клиентские библиотеки

Website Analytics

​

Website traffic, engagement, audience, rankings and search data.

Website Analytics Операции

Рейтинг топ-сайтов Similarweb

​

Возвращает рейтинг сайтов для отраслевой категории. category и limit обязательны. limit должен быть от 1 до 20. country поддерживает только общемировые данные (ww) и по умолчанию равно ww. offset управляет пагинацией. Ответ содержит meta и data.

Справочная информация о ценах

  • Тарификация: тарифицируемое количество результатов.
  • Справочная оценка запроса: USD 0.075.
  • Базовая стоимость единицы: USD 0.075.
  • Единица ресурса: similarweb_credit.
  • Справочный множитель для клиента: 1.0. Не применяйте его повторно к уже рассчитанной сумме клиента.
  • Базовые стоимости не определяют итоговую цену для клиента, в том числе когда они равны нулю.

Только справочные метаданные, а не котировка для аккаунта, гарантированная цена или лимит расходов. Кредиты ресурсов — не кредиты Felo. Итоговые списания определяются записями биллинга Felo.

Query-параметры
  • category
    Тип: string
    мин. длина:  
    1
    макс. длина:  
    191
    обязательно
  • country
    enum
    константа:  
    ww

    Только общемировые данные; значения нечувствительны к регистру.

    значения
    • ww
  • limit
    Тип: integer
    мин.:  
    1
    макс.:  
    20
    обязательно

    Integer numbers.

  • offset
    Тип: integer
    мин.:  
    0
    макс.:  
    100000

    Integer numbers.

Ответы
  • 200
    Тип: object

    Конверт SimilarWeb v5 (meta + data).

    • data
      Тип: array object[]
      • domain
        Тип: string
      • rank
        Тип: integer

        Integer numbers.

    • meta
      Тип: object · ResponseC6C9032778Bd_SimilarWebMeta

      Метаданные конверта ответа SimilarWeb v5.

      • status
        Тип: string
        обязательно

        Статус upstream; 'success' при успешном вызове.

      • last_updated
        Тип: string

        Дата последней доступной в upstream точки данных (YYYY-MM-DD).

      • query
        Тип: object

        Эхо пагинации/сортировки, если применимо (limit, offset, asc, sort).

      • request
        Тип: object

        Полное эхо нормализованного upstream-запроса (параметры в том виде, в котором они получены).

    application/json
  • 400

    Запрос не удалось обработать. Проверьте параметры запроса.

  • 401

    Требуется действительный API-ключ Felo.

  • 402

    Запрос не может быть выполнен: не выполнено требование биллинга.

  • 403

    Аккаунту не разрешено выполнять эту операцию.

  • 429

    Достигнут лимит запросов или расходов.

  • 502

    Сервис не смог выполнить запрос.

  • 503

    API или сервис биллинга временно недоступны.

  • 504

    Истекло время ожидания обработки запроса.

  • default

    Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера

    application/json
Request Example for get/v1/beta/similarweb/website/top-sites-ranking
curl --request GET https://openapi.felo.ai/v1/beta/similarweb/website/top-sites-ranking \
  --header "Authorization: Bearer ${FELO_API_KEY:?Set FELO_API_KEY}" \
  --get \
  --data-urlencode category=Finance \
  --data-urlencode limit=5 \
  --data-urlencode country=ww \
  --data-urlencode offset=0
{
  "meta": {
    "query": {
      "limit": 5,
      "offset": 0
    },
    "request": {
      "category": "Finance",
      "country": "ww"
    },
    "status": "success",
    "last_updated": "2026-09-01"
  },
  "data": [
    {
      "domain": "example.com",
      "rank": 1
    }
  ]
}
Similarweb Top Sites Ranking

Нужна помощь?