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

Demographics

Felo API Support
MIT
サーバー:https://openapi.felo.ai
クライアントライブラリ
Shell Curl

Website Analytics

​

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

Website Analytics 操作

Demographics

​

Demographics. Response follows the SimilarWeb v5 envelope (meta + data). Date constraint: start_date and end_date must fall in the SAME month (exactly one monthly bucket).

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

    Target domain, e.g. example.com.

  • start_date
    型: string
    必須

    Start month, format YYYY-MM.

  • end_date
    型: string
    必須

    End month, format YYYY-MM.

  • granularity
    列挙値
    定数:  
    monthly
    必須

    Time granularity. Allowed: monthly.

    値
    • monthly
  • country
    型: string 列挙値

    Two-letter country code. Allowed: us, ww. Default: ww. Coverage is limited to ww and us on the current plan.

    値
    • us
    • ww
  • web_source
    列挙値
    定数:  
    total

    Traffic source device split. Allowed: total.

    値
    • total
  • main_domain_only
    型: boolean

    Restrict to the main domain only (true/false).

  • format
    列挙値
    定数:  
    json

    Response format. Allowed: json.

    値
    • json
レスポンス
  • 200
    型: object

    SimilarWeb v5 envelope (meta + data).

    • data
      型: array object[]
      • age_18_to_24_share
        型: number
      • age_25_to_34_share
        型: number
      • age_35_to_44_share
        型: number
      • age_45_to_54_share
        型: number
      • age_55_to_64_share
        型: number
      • age_65_plus_share
        型: number
      • female_share
        型: number
      • male_share
        型: number
    • meta
      型: object · SimilarWebMeta

      SimilarWeb v5 response envelope metadata.

      • status
        型: string
        必須

        Operation status; success for a successful lookup.

      • last_updated
        型: string

        Date of the most recent available data point (YYYY-MM-DD).

      • query
        型: object

        Pagination/sort echo when applicable (limit, offset, asc, sort).

      • request
        型: object

        Normalized request parameters used for this lookup.

    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/demographics
curl 'https://openapi.felo.ai/v1/beta/similarweb/website/demographics?domain=&start_date=&end_date=&granularity=monthly' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "meta": {
    "request": {
      "format": "json",
      "domain": "cnn.com",
      "granularity": "monthly",
      "country": "us",
      "start_date": "2026-06-01",
      "end_date": "2026-06-30",
      "metrics": [
        "age_18_to_24_share",
        "age_25_to_34_share",
        "age_35_to_44_share",
        "age_45_to_54_share",
        "age_55_to_64_share",
        "age_65_plus_share",
        "male_share",
        "female_share"
      ]
    },
    "status": "success",
    "last_updated": "2026-07-31"
  },
  "data": [
    {
      "age_18_to_24_share": 0.0684928856109901,
      "age_25_to_34_share": 0.16978297333160164,
      "age_35_to_44_share": 0.202684431962113,
      "age_45_to_54_share": 0.2104190356035189,
      "age_55_to_64_share": 0.21167119791609917,
      "age_65_plus_share": 0.1369494755756772,
      "male_share": 0.5816619373492008,
      "female_share": 0.4183380626507992
    }
  ]
}

SimilarWeb v5 envelope (meta + data).

Demographics