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 Операции

Топ-географии сайта

​

Ведущие страны по доле трафика домена за последний доступный месяц (data.countries, до 10 строк с country_code, country_name, share и visits). География — всемирная (ww) и фиксированная: параметр country для этого эндпоинта не принимается.

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

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

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

Query-параметры
  • 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
        enum
        константа:  
        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

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

    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.607Z",
    "source": "similarweb",
    "start_date": "string"
  }
}
Website Top Geographies

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