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

Top-Geografien der Website

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

Website Analytics

​

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

Top-Geografien der Website

​

Top-Länder nach Anteil am Traffic einer Domain für den letzten verfügbaren Monat (data.countries, bis zu 10 Zeilen mit country_code, country_name, share und visits). Die geografische Abdeckung ist weltweit (ww) und fest: Ein country-Parameter wird für diesen Endpunkt nicht akzeptiert.

Preisreferenz

  • Abrechnung: Abgerechnete Ergebnisanzahl.
  • Referenzschätzung pro Anfrage: USD 2.25.
  • 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
  • domain
    Typ: string
    erforderlich

    Reiner Website-Hostname ohne Schema, Pfad, Port oder Anmeldedaten.

  • month
    Typ: string

    Vollständiger Monat im Format YYYY-MM. Standardmäßig der vorherige vollständige UTC-Monat.

Antworten
  • 200
    Typ: object

    Normalisierte erfolgreiche Antwort

    • data
      Typ: object
      erforderlich
      • countries
        Typ: array object[] 1…10
        erforderlich
        • country_code
          Typ: string
          erforderlich
        • country_name
          Typ: string
          erforderlich
        • rank
          Typ: number | null
          erforderlich
        • share
          Typ: number | null
          erforderlich
        • visits
          Typ: number | null
          erforderlich
    • meta
      Typ: object
      erforderlich
      • country
        enum
        Konstante:  
        ww
        erforderlich
        Werte
        • ww
      • end_date
        Typ: string
        erforderlich
      • granularity
        Konstante:  
        monthly
        erforderlich
      • request_id
        Typ: string
        erforderlich
      • retrieved_at
        Typ: string Format: date-time
        erforderlich

        the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

      • source
        Konstante:  
        similarweb
        erforderlich
      • start_date
        Typ: string
        erforderlich
    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-geographies
curl 'https://openapi.felo.ai/v1/beta/similarweb/website-top-geographies?domain=example.com' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "data": {
    "countries": [
      {
        "country_code": "string",
        "country_name": "string",
        "rank": null,
        "share": null,
        "visits": null
      }
    ]
  },
  "meta": {
    "country": "ww",
    "end_date": "string",
    "granularity": "monthly",
    "request_id": "string",
    "retrieved_at": "2026-10-26T08:08:16.601Z",
    "source": "similarweb",
    "start_date": "string"
  }
}
Website Top Geographies