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

Similarweb Top-Sites-Ranking

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

Website Analytics

​

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

Similarweb Top-Sites-Ranking

​

Gibt Website-Rankings für eine Branchenkategorie zurück. category und limit sind erforderlich. limit muss zwischen 1 und 20 liegen. country unterstützt nur weltweite Daten (ww) und ist standardmäßig ww. offset steuert die Paginierung. Die Antwort enthält meta und data.

Preisreferenz

  • Abrechnung: Abrechnete Ergebnisanzahl.
  • Referenzschätzung pro Anfrage: USD 0.075.
  • Kostenbasis pro Einheit: USD 0.075.
  • Ressourceneinheit: similarweb_credit.
  • Referenz-Kundenmultiplikator: 1.0. Nicht erneut auf bereits abgerechnete Kundenbeträge 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
  • category
    Typ: string
    min. Länge:  
    1
    max. Länge:  
    191
    erforderlich
  • country
    enum
    Konstante:  
    ww

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

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

    Integer numbers.

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

    Integer numbers.

Antworten
  • 200
    Typ: object

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

    • data
      Typ: array object[]
      • domain
        Typ: string
      • rank
        Typ: integer

        Integer numbers.

    • meta
      Typ: object · ResponseC6C9032778Bd_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/website/top-sites-ranking
curl --request GET https://openapi.felo.ai/v1/beta/similarweb/website/top-sites-ranking \
  --header "Authorization: Bearer ${FELO_API_KEY:?Set FELO_API_KEY}" \
  --get \
  --data-urlencode category=Finance \
  --data-urlencode limit=5 \
  --data-urlencode country=ww \
  --data-urlencode offset=0
{
  "meta": {
    "query": {
      "limit": 5,
      "offset": 0
    },
    "request": {
      "category": "Finance",
      "country": "ww"
    },
    "status": "success",
    "last_updated": "2026-09-01"
  },
  "data": [
    {
      "domain": "example.com",
      "rank": 1
    }
  ]
}
Similarweb Top Sites Ranking