Felo API PlatformFelo API Platform
Alle Endpoints von Similarweb
v0.2.0-beta
OpenAPI 3.1.0

SERP-Player – aggregiert

Server:https://openapi.felo.ai
Client-Bibliotheken

Website Analytics

​

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

SERP-Player – aggregiert

​

SERP-Player – aggregiert. Die Antwort folgt der SimilarWeb-v5-Hülle (meta + data).

Preisreferenz

  • Abrechnung: Abgerechnete Ergebnisanzahl.
  • Referenzschätzung pro Anfrage: USD 0.075.
  • Kostenbasis pro Einheit: USD 0.075.
  • Ressourceneinheit: similarweb_credit.
  • Referenz-Kundenmultiplikator: 1.0. Nicht erneut auf einen abgerechneten Kundenbetrag anwenden.
  • Kostenbasen legen den endgültigen Kundenpreis nicht fest, auch nicht bei null.

Nur Referenzmetadaten, kein Kontenangebot, kein garantierter Preis und keine Ausgabenobergrenze. Ressourcen-Credits sind keine Felo-Credits. Endgültige Abrechnungen richten sich nach den Felo-Abrechnungsbelegen.

Query-Parameter
  • country
    enum
    Konstante:  
    ww

    Nur weltweite Daten; Werte sind nicht groß-/kleinschreibungssensitiv.

    Werte
    • ww
  • end_date
    Typ: string
    erforderlich
  • granularity
    enum
    Konstante:  
    monthly
    Werte
    • monthly
  • keywords
    Typ: string
    erforderlich

    Elementtrennzeichen: ,. Höchstens 1 getrenntes Element. Mindestens 1 getrenntes Element.

  • limit
    Typ: integer
    min.:  
    1
    max.:  
    20
    erforderlich

    Integer numbers.

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

    Integer numbers.

  • start_date
    Typ: string
    erforderlich
Antworten
  • 200
    Typ: object

    SimilarWeb-v5-Hülle (meta + data).

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

        Summe der Klicks, die die Domain für das analysierte Keyword erhält

      • domain
        Typ: string | null

        Website-Domain ohne 'www.' (z. B. 'example.com')

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

        Website-Subdomain ohne 'www.' (z. B. 'developer.example.com')

      • top_url
        Typ: string | null

        Die Website-URL mit der höchsten organischen Position, die für das analysierte Keyword rankt

      • top_url_position
        Typ: integer | null Format: int32

        Aktuelle beste kombinierte Position der top_url im ausgewählten Zeitraum

      • traffic_share
        Typ: number | null Format: double

        Der Anteil des Datenverkehrs zur Website

    • meta
      Typ: object · Response62E957Bfd704_SimilarWebMeta

      Metadaten des Antwort-Envelopes von SimilarWeb v5.

      • status
        Typ: string
        erforderlich

        Upstream-Status; bei einem erfolgreichen Aufruf 'success'.

      • last_updated
        Typ: string

        Datum des letzten im Upstream verfügbaren Datenpunkts (YYYY-MM-DD).

      • query
        Typ: object

        Echo von Paginierung/Sortierung, sofern zutreffend (limit, offset, asc, sort).

      • request
        Typ: object

        Vollständiges Echo der normalisierten Upstream-Anfrage (Parameter wie empfangen).

    application/json
  • 400

    Die Anfrage konnte nicht verarbeitet werden. Prüfen Sie die Anfrageparameter.

  • 401

    Ein gültiger Felo-API-Schlüssel ist erforderlich.

  • 402

    Die Anfrage kann nicht fortgesetzt werden, da eine Abrechnungsvoraussetzung nicht erfüllt ist.

  • 403

    Das Konto ist für diesen Vorgang nicht berechtigt.

  • 429

    Ein Anfrage- oder Ausgabenlimit wurde erreicht.

  • 502

    Der Dienst konnte die Anfrage nicht abschließen.

  • 503

    Die API oder der Abrechnungsdienst ist vorübergehend nicht verfügbar.

  • 504

    Beim Verarbeiten der Anfrage ist eine Zeitüberschreitung aufgetreten.

  • default

    Fehlerantwort; Upstream-Passthrough-Antworten können Anbieterformate verwenden

    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