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

SERP Players - Aggregated

Сервер:https://openapi.felo.ai
Клиентские библиотеки

Website Analytics

​

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

SERP Players - Aggregated

​

SERP Players - Aggregated. Response follows the SimilarWeb v5 envelope (meta + data).

Query-параметры
  • keyword
    Тип: string
    обязательно

    Target keyword.

  • start_date
    Тип: string
    обязательно

    Start month, format YYYY-MM.

  • end_date
    Тип: string
    обязательно

    End month, format YYYY-MM.

  • granularity
    enum
    константа:  
    monthly

    Time granularity. Allowed: monthly.

    значения
    • monthly
  • limit
    Тип: integer
    макс.:  
    20
    обязательно

    Number of rows to return; max 20, billed as 20 if exceeded.

  • country
    Тип: string enum

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

    значения
    • us
    • ww
  • offset
    Тип: integer

    Row offset for pagination.

Ответы
  • 200
    Тип: object

    SimilarWeb v5 envelope (meta + data).

    • data
      Тип: array object[]
      • clicks
        Тип: number
      • domain
        Тип: string
      • serp_features
        Тип: array string[] | string
      • site
        Тип: string
      • top_url
        Тип: string
      • top_url_position
        Тип: integer

        Integer numbers.

      • traffic_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/search/serp-players-aggregated
curl 'https://openapi.felo.ai/v1/beta/similarweb/search/serp-players-aggregated?keyword=&start_date=&end_date=&limit=20' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "meta": {
    "query": {
      "limit": 5,
      "offset": 0,
      "asc": null,
      "sort": null
    },
    "request": {
      "format": "json",
      "keyword": "nike",
      "granularity": "monthly",
      "country": "us",
      "start_date": "2026-06-01",
      "end_date": "2026-06-30",
      "traffic_source": "all",
      "web_source": "total",
      "metrics": [
        "clicks",
        "traffic_share",
        "serp_features",
        "top_url",
        "top_url_position"
      ],
      "is_keyword_group": false
    },
    "status": "success",
    "last_updated": "2026-07-31"
  },
  "data": [
    {
      "site": "nike.com",
      "domain": "nike.com",
      "clicks": 995980.9211660791,
      "traffic_share": 0.9220950172205099,
      "serp_features": [
        "pla",
        "paid",
        "paid_sitelinks",
        "organic_expanded_sitelinks",
        "organic_sitelinks",
        "organic"
      ],
      "top_url_position": 1,
      "top_url": "nike.com"
    }
  ]
}
SERP Players - Aggregated