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

Игроки SERP — агрегировано

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

Website Analytics

​

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

Игроки SERP — агрегировано

​

Игроки SERP — агрегировано. Ответ следует конверту SimilarWeb v5 (meta + data).

Справочные цены

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

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

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

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

    значения
    • ww
  • end_date
    Тип: string
    обязательно
  • granularity
    enum
    константа:  
    monthly
    значения
    • monthly
  • keywords
    Тип: string
    обязательно

    Разделитель элементов: ,. Максимум 1 элемент с разделителем. Минимум 1 элемент с разделителем.

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

    Integer numbers.

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

    Integer numbers.

  • start_date
    Тип: string
    обязательно
Ответы
  • 200
    Тип: object

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

    • data
      Тип: array object[]
      • clicks
        Тип: number | null Формат: double

        Сумма кликов, которые домен получает по анализируемому ключевому слову

      • domain
        Тип: string | null

        Домен веб-сайта без 'www.' (например, 'example.com')

      • serp_features
        Тип: array string[] | string
      • site
        Тип: string | null

        Поддомен веб-сайта без 'www.' (например, 'developer.example.com')

      • top_url
        Тип: string | null

        URL сайта с самой высокой органической позицией в выдаче по анализируемому ключевому слову

      • top_url_position
        Тип: integer | null Формат: int32

        Последняя смешанная позиция top_url в выбранном временном диапазоне

      • traffic_share
        Тип: number | null Формат: double

        Доля трафика на веб-сайт

    • meta
      Тип: object · Response62E957Bfd704_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/search/serp-players-aggregated
curl 'https://openapi.felo.ai/v1/beta/similarweb/search/serp-players-aggregated?end_date=2026-09&keywords=example&limit=1&start_date=2026-09' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "meta": {
    "status": "success",
    "last_updated": "2026-06-30",
    "request": {},
    "query": {}
  },
  "data": [
    {
      "site": null,
      "domain": null,
      "clicks": null,
      "traffic_share": null,
      "serp_features": [
        "string"
      ],
      "top_url_position": null,
      "top_url": null
    }
  ]
}
SERP Players - Aggregated

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