Felo API PlatformFelo API Platform
v0.1.0-beta
OpenAPI 3.1.0

Website Top Geographies

サーバー:https://openapi.felo.ai
クライアントライブラリ

Website Analytics

​

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

Website Top Geographies

​

Top countries by share of a domain's traffic for the latest available month (data.countries, up to 10 rows with country_code, country_name, share and visits). Geography coverage is worldwide (ww) and fixed: a country parameter is not accepted for this endpoint.

クエリパラメーター
  • domain
    型: string
    必須

    Target domain, e.g. example.com.

レスポンス
  • 200
    型: object

    SimilarWeb traffic response (meta + data). data.countries is ranked by traffic share (highest first).

    • data
      型: object
      • countries
        型: array object[]
        • country_code
          型: string
        • country_name
          型: string
        • rank
          型: integer null 許容

          Integer numbers.

        • share
          型: number
        • visits
          型: number
    • meta
      型: object
      • country
        型: string
      • end_date
        型: string
      • granularity
        型: string
      • request_id
        型: string
      • retrieved_at
        型: string
      • source
        型: string
      • start_date
        型: string
    application/json
  • 400

    The request could not be processed. Check the request parameters.

  • 401

    A valid Felo API key is required.

  • 402

    The request cannot proceed because a billing requirement is not met.

  • 403

    The account is not permitted to perform this operation.

  • 429

    A request or spending limit has been reached.

  • 502

    The service could not complete the request.

  • 503

    The API or billing service is temporarily unavailable.

  • 504

    The service timed out while processing the request.

  • default

    The operation failed. Keep the response request ID when contacting Felo support.

Request Example for get/v1/beta/similarweb/website-top-geographies
curl 'https://openapi.felo.ai/v1/beta/similarweb/website-top-geographies?domain=' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "data": {
    "countries": [
      {
        "country_code": "us",
        "country_name": "United States",
        "rank": null,
        "share": 0.8135986038373749,
        "visits": 184871830.97664917
      },
      {
        "country_code": "ca",
        "country_name": "Canada",
        "rank": null,
        "share": 0.1250244855835728,
        "visits": 28408978.896636344
      },
      {
        "country_code": "gb",
        "country_name": "United Kingdom",
        "rank": null,
        "share": 0.0046361238147776184,
        "visits": 1053453.9934433121
      },
      {
        "country_code": "in",
        "country_name": "India",
        "rank": null,
        "share": 0.004525631464841616,
        "visits": 1028347.1127957336
      },
      {
        "country_code": "au",
        "country_name": "Australia",
        "rank": null,
        "share": 0.0038766416446363557,
        "visits": 880878.8947080157
      },
      {
        "country_code": "za",
        "country_name": "South Africa",
        "rank": null,
        "share": 0.0032450884260539874,
        "visits": 737372.7488913544
      },
      {
        "country_code": "sg",
        "country_name": "Singapore",
        "rank": null,
        "share": 0.0029357496450864123,
        "visits": 667082.5264649267
      },
      {
        "country_code": "de",
        "country_name": "Germany",
        "rank": null,
        "share": 0.002332122537702222,
        "visits": 529921.9560768788
      },
      {
        "country_code": "nl",
        "country_name": "Netherlands",
        "rank": null,
        "share": 0.0022503248115619393,
        "visits": 511335.2779164732
      },
      {
        "country_code": "nz",
        "country_name": "New Zealand",
        "rank": null,
        "share": 0.002059521596153513,
        "visits": 467979.5744744864
      }
    ]
  },
  "meta": {
    "country": "ww",
    "end_date": "2026-07",
    "granularity": "monthly",
    "request_id": "imc_7d699adfa9e84a0e867521b2d071c2bb35f887a6f6b7c1e5d95067a1dfc2f2fa",
    "retrieved_at": "2026-08-27T14:47:22.508241524Z",
    "source": "similarweb",
    "start_date": "2026-07"
  }
}
Website Top Geographies