Felo API PlatformFelo API Platform
Все эндпоинты Similarweb
v0.2.0-beta
OpenAPI 3.1.0
Сервер:https://openapi.felo.ai
Клиентские библиотеки

Website Analytics

​

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

Website Analytics Операции

SimilarSites

​

SimilarSites. Ответ следует конверту SimilarWeb v5 (meta + data). Ограничение по датам (требование upstream SimilarWeb): start_date и end_date должны охватывать РОВНО 3 последовательных месяца — диапазон в 1 или 2 месяца отклоняется с ошибкой upstream 120 ('must span exactly 3 month(s)'). Этот диапазон также должен быть самым последним поддерживаемым окном SimilarWeb, которое сдвигается вперёд каждый месяц; более старый или выходящий за пределы диапазон отклоняется с ошибкой 101 ('Dates not in range'). На практике запрашивайте три последних завершённых месяца (например, если последний опубликованный месяц — 2026-07, используйте start_date=2026-05 и end_date=2026-07). Чтобы узнать точный текущий поддерживаемый диапазон, вызовите эндпоинт /describe SimilarWeb для этого API.

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

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

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

Query-параметры
  • country
    enum
    константа:  
    ww

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

    значения
    • ww
  • domain
    Тип: string
    мин. длина:  
    1
    макс. длина:  
    253
    обязательно
  • end_date
    Тип: string
    обязательно
  • granularity
    enum
    константа:  
    monthly
    значения
    • monthly
  • limit
    Тип: integer
    мин.:  
    1
    макс.:  
    20
    обязательно

    Integer numbers.

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

    Integer numbers.

  • start_date
    Тип: string
    обязательно
  • traffic_source
    Тип: string
  • web_source
    Тип: string enum
    значения
    • desktop
    • mobile_web
    • total
Ответы
  • 200
    Тип: object

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

    • data
      Тип: array object[]
      • affinity
        Тип: number
      • category
        Тип: string
      • domain
        Тип: string
      • has_adsense
        Тип: boolean
      • rank
        Тип: integer

        Integer numbers.

    • meta
      Тип: object · Response7B51F63Afd06_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/similar-sites
curl 'https://openapi.felo.ai/v1/beta/similarweb/website/similar-sites?domain=cnn.com&end_date=2026-09&limit=1&start_date=2026-07' \
  --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
    }
  ]
}
SimilarSites

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