Felo API PlatformFelo API Platform
All Similarweb endpoints
v0.2.0-beta
OpenAPI 3.1.0

SERP Players - Aggregated

Server:https://openapi.felo.ai
Client Libraries

Website Analytics

​

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

SERP Players - Aggregated

​

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

Pricing reference

  • Metering: Metered result count.
  • Reference request estimate: USD 0.075.
  • Unit cost basis: USD 0.075.
  • Resource unit: similarweb_credit.
  • Reference customer multiplier: 1.0. Do not apply it again to a settled customer amount.
  • Cost bases do not establish the final customer price, including when zero.

Reference metadata only, not an account quote, a guaranteed price or a spending cap. Resource credits are not Felo credits. Final charges follow Felo billing records.

Query Parameters
  • country
    enum
    const:  
    ww

    Worldwide data only; values are case-insensitive.

    values
    • ww
  • end_date
    Type: string
    required
  • granularity
    enum
    const:  
    monthly
    values
    • monthly
  • keywords
    Type: string
    required

    Item delimiter: ,. At most 1 delimited items. At least 1 delimited items.

  • limit
    Type: integer
    min:  
    1
    max:  
    20
    required

    Integer numbers.

  • offset
    Type: integer
    min:  
    0
    max:  
    100000

    Integer numbers.

  • start_date
    Type: string
    required
Responses
  • 200
    Type: object

    SimilarWeb v5 envelope (meta + data).

    • data
      Type: array object[]
      • clicks
        Type: number | null Format: double

        Sum of clicks the domain receives for the analyzed keyword

      • domain
        Type: string | null

        Website domain without 'www.' (e.g., 'example.com')

      • serp_features
        Type: array string[] | string
      • site
        Type: string | null

        Website sub-domain without 'www.' (e.g., 'developer.example.com')

      • top_url
        Type: string | null

        The site url with the highest organic position that ranks for the analyzed keyword

      • top_url_position
        Type: integer | null Format: int32

        Top latest blended position of the top_url in the selected timeframe

      • traffic_share
        Type: number | null Format: double

        The share of the traffic to the website

    • meta
      Type: object · Response62E957Bfd704_SimilarWebMeta

      SimilarWeb v5 response envelope metadata.

      • status
        Type: string
        required

        Upstream status; 'success' on a successful call.

      • last_updated
        Type: string

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

      • query
        Type: object

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

      • request
        Type: object

        Full echo of the normalized upstream request (parameters as received).

    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

    Error response; upstream passthrough responses may use provider formats

    application/json
Request Example for get/v1/beta/similarweb/search/serp-players-aggregated
curl 'https://openapi.felo.ai/v1/beta/similarweb/search/serp-players-aggregated?end_date=2026-09&keywords=example&limit=1&start_date=2026-09' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "meta": {
    "status": "success",
    "last_updated": "2026-06-30",
    "request": {},
    "query": {}
  },
  "data": [
    {
      "site": null,
      "domain": null,
      "clicks": null,
      "traffic_share": null,
      "serp_features": [
        "string"
      ],
      "top_url_position": null,
      "top_url": null
    }
  ]
}
SERP Players - Aggregated

Need help?