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

Топ-географії сайту

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

Website Analytics

​

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

Website Analytics Операції

Топ-географії сайту

​

Провідні країни за часткою трафіку домену за останній доступний місяць (data.countries, до 10 рядків із country_code, country_name, share і visits). Географія — всесвітня (ww) і фіксована: параметр country для цього ендпоінта не приймається.

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

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

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

Параметри запиту
  • domain
    Тип: string
    обов'язкове

    Голе ім'я хоста сайту без схеми, шляху, порту та облікових даних.

  • month
    Тип: string

    Повний місяць у форматі YYYY-MM. Типово — попередній повний місяць UTC.

Відповіді
  • 200
    Тип: object

    Нормалізована успішна відповідь

    • data
      Тип: object
      обов'язкове
      • countries
        Тип: array object[] 1…10
        обов'язкове
        • country_code
          Тип: string
          обов'язкове
        • country_name
          Тип: string
          обов'язкове
        • rank
          Тип: number | null
          обов'язкове
        • share
          Тип: number | null
          обов'язкове
        • visits
          Тип: number | null
          обов'язкове
    • meta
      Тип: object
      обов'язкове
      • country
        перелік
        константа:  
        ww
        обов'язкове
        значення
        • ww
      • end_date
        Тип: string
        обов'язкове
      • granularity
        константа:  
        monthly
        обов'язкове
      • request_id
        Тип: string
        обов'язкове
      • retrieved_at
        Тип: string Формат: date-time
        обов'язкове

        the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

      • source
        константа:  
        similarweb
        обов'язкове
      • start_date
        Тип: string
        обов'язкове
    application/json
  • 400

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

  • 401

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

  • 402

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

  • 403

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

  • 429

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

  • 502

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

  • 503

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

  • 504

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

  • default

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

    application/json
Request Example for get/v1/beta/similarweb/website-top-geographies
curl 'https://openapi.felo.ai/v1/beta/similarweb/website-top-geographies?domain=example.com' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "data": {
    "countries": [
      {
        "country_code": "string",
        "country_name": "string",
        "rank": null,
        "share": null,
        "visits": null
      }
    ]
  },
  "meta": {
    "country": "ww",
    "end_date": "string",
    "granularity": "monthly",
    "request_id": "string",
    "retrieved_at": "2026-10-26T08:08:16.601Z",
    "source": "similarweb",
    "start_date": "string"
  }
}

Нормалізована успішна відповідь

Website Top Geographies