Felo API PlatformFelo API Platform
Усі endpoint Similarweb
v0.2.0-beta
OpenAPI 3.1.0

Гравці SERP — агреговано

Felo API Support
MIT
Сервер:https://openapi.felo.ai
Клієнтські бібліотеки
Shell Curl

Website Analytics

​

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

Website Analytics Операції

Гравці SERP — агреговано

​

Гравці SERP — агреговано. Відповідь відповідає конверту SimilarWeb v5 (meta + data).

Довідкові ціни

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

Довідкові метадані, а не котирування для облікового запису, гарантована ціна чи ліміт витрат. Кредити ресурсів — це не кредити Felo. Остаточні списання здійснюються за записами білінгу Felo.

Параметри запиту
  • country
    перелік
    константа:  
    ww

    Лише світові дані; значення нечутливі до регістру.

    значення
    • ww
  • end_date
    Тип: string
    обов'язкове
  • granularity
    перелік
    константа:  
    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
        обов'язкове

        Статус апстріму; 'success' у разі успішного виклику.

      • last_updated
        Тип: string

        Дата останньої доступної в апстрімі точки даних (YYYY-MM-DD).

      • query
        Тип: object

        Відлуння пагінації/сортування, якщо застосовно (limit, offset, asc, sort).

      • request
        Тип: object

        Повне відлуння нормалізованого запиту до апстріму (параметри в тому вигляді, у якому їх отримано).

    application/json
  • 400

    Не вдалося обробити запит. Перевірте параметри запиту.

  • 401

    Потрібен дійсний API-ключ Felo.

  • 402

    Запит неможливо виконати: умови білінгу не виконано.

  • 403

    Обліковий запис не має дозволу на цю операцію.

  • 429

    Досягнуто ліміту запитів або витрат.

  • 502

    Служба не змогла виконати запит.

  • 503

    API або служба білінгу тимчасово недоступні.

  • 504

    Час очікування обробки запиту вичерпано.

  • default

    Відповідь із помилкою; наскрізні відповіді апстріму можуть використовувати формати постачальника

    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
    }
  ]
}

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

SERP Players - Aggregated