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

SERP-spelers - geaggregeerd

Server:https://openapi.felo.ai
Clientbibliotheken

Website Analytics

​

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

SERP-spelers - geaggregeerd

​

SERP-spelers - geaggregeerd. De respons volgt de SimilarWeb v5-envelop (meta + data).

Prijsreferentie

  • Metering: Gemeten resultaataantal.
  • Referentieschatting per verzoek: USD 0.075.
  • Kostenbasis per eenheid: USD 0.075.
  • Resource-eenheid: similarweb_credit.
  • Referentieklantvermenigvuldiger: 1.0. Pas deze niet opnieuw toe op een afgerekend klantbedrag.
  • Kostenbases bepalen niet de uiteindelijke klantprijs, ook niet wanneer die nul is.

Alleen referentiemetadata, geen accountofferte, geen gegarandeerde prijs en geen bestedingslimiet. Resourcecredits zijn geen Felo-tegoed. De uiteindelijke kosten volgen de factureringsgegevens van Felo.

Queryparameters
  • country
    enum
    constante:  
    ww

    Alleen wereldwijde gegevens; waarden zijn niet hoofdlettergevoelig.

    waarden
    • ww
  • end_date
    Type: string
    verplicht
  • granularity
    enum
    constante:  
    monthly
    waarden
    • monthly
  • keywords
    Type: string
    verplicht

    Itemscheidingsteken: ,. Maximaal 1 gescheiden item. Minimaal 1 gescheiden item.

  • limit
    Type: integer
    min.:  
    1
    max.:  
    20
    verplicht

    Integer numbers.

  • offset
    Type: integer
    min.:  
    0
    max.:  
    100000

    Integer numbers.

  • start_date
    Type: string
    verplicht
Responsen
  • 200
    Type: object

    SimilarWeb v5-envelop (meta + data).

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

        Som van de klikken die het domein ontvangt voor het geanalyseerde keyword

      • domain
        Type: string | null

        Websitedomein zonder 'www.' (bijv. 'example.com')

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

        Websitesubdomein zonder 'www.' (bijv. 'developer.example.com')

      • top_url
        Type: string | null

        De site-URL met de hoogste organische positie die rankt voor het geanalyseerde keyword

      • top_url_position
        Type: integer | null Formaat: int32

        Nieuwste beste gecombineerde positie van de top_url in het geselecteerde tijdsbestek

      • traffic_share
        Type: number | null Formaat: double

        Het aandeel van het verkeer naar de website

    • meta
      Type: object · Response62E957Bfd704_SimilarWebMeta

      Metadata van de SimilarWeb v5-responsenvelop.

      • status
        Type: string
        verplicht

        Upstream-status; 'success' bij een geslaagde aanroep.

      • last_updated
        Type: string

        Datum van het meest recente upstream beschikbare gegevenspunt (YYYY-MM-DD).

      • query
        Type: object

        Echo van paginering/sortering indien van toepassing (limit, offset, asc, sort).

      • request
        Type: object

        Volledige echo van het genormaliseerde upstream-verzoek (parameters zoals ontvangen).

    application/json
  • 400

    Het verzoek kon niet worden verwerkt. Controleer de verzoekparameters.

  • 401

    Een geldige Felo-API-sleutel is vereist.

  • 402

    Het verzoek kan niet doorgaan omdat niet aan een factureringsvoorwaarde is voldaan.

  • 403

    Het account mag deze bewerking niet uitvoeren.

  • 429

    Een verzoek- of bestedingslimiet is bereikt.

  • 502

    De dienst kon het verzoek niet voltooien.

  • 503

    De API of factureringsdienst is tijdelijk niet beschikbaar.

  • 504

    Er is een time-out opgetreden bij het verwerken van het verzoek.

  • default

    Foutrespons; upstream-passthrough-responsen kunnen indelingen van de provider gebruiken

    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