Felo API PlatformFelo API Platform
Wszystkie endpointy Similarweb
v0.2.0-beta
OpenAPI 3.1.0

Najważniejsze kraje witryny

Felo API Support
MIT
Serwer:https://openapi.felo.ai
Biblioteki klienckie
Shell Curl

Website Analytics

​

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

Website Analytics Operacje

Najważniejsze kraje witryny

​

Najważniejsze kraje według udziału w ruchu domeny w najnowszym dostępnym miesiącu (data.countries, do 10 wierszy z country_code, country_name, share i visits). Zasięg geograficzny jest globalny (ww) i stały: ten endpoint nie przyjmuje parametru country.

Cennik referencyjny

  • Rozliczanie: według liczby wyników.
  • Szacunek referencyjny dla żądania: USD 2.25.
  • Podstawa kosztu jednostkowego: USD 0.075.
  • Jednostka zasobów: similarweb_credit.
  • Referencyjny mnożnik klienta: 1.0. Nie stosuj go ponownie do rozliczonej kwoty klienta.
  • Podstawy kosztu nie określają ostatecznej ceny dla klienta, także gdy wynoszą zero.

Wyłącznie metadane referencyjne, a nie wycena konta, gwarantowana cena lub limit wydatków. Kredyty zasobów nie są kredytami Felo. Ostateczne obciążenia są zgodne z zapisami rozliczeniowymi Felo.

Parametry zapytania
  • domain
    Typ: string
    wymagane

    Sama nazwa hosta witryny, bez schematu, ścieżki, portu i danych uwierzytelniających.

  • month
    Typ: string

    Pełny miesiąc w formacie YYYY-MM. Domyślnie poprzedni pełny miesiąc UTC.

Odpowiedzi
  • 200
    Typ: object

    Znormalizowana pomyślna odpowiedź

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

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

      • source
        const:  
        similarweb
        wymagane
      • start_date
        Typ: string
        wymagane
    application/json
  • 400

    Nie można przetworzyć żądania. Sprawdź parametry żądania.

  • 401

    Wymagany jest prawidłowy klucz API Felo.

  • 402

    Nie można kontynuować żądania, ponieważ nie spełniono wymogu rozliczeniowego.

  • 403

    Konto nie ma uprawnień do wykonania tej operacji.

  • 429

    Osiągnięto limit żądań lub wydatków.

  • 502

    Usługa nie mogła ukończyć żądania.

  • 503

    API lub usługa rozliczeniowa jest tymczasowo niedostępna.

  • 504

    Upłynął limit czasu usługi podczas przetwarzania żądania.

  • default

    Odpowiedź błędu; odpowiedzi przekazywane bezpośrednio od dostawcy upstream mogą używać formatów dostawcy

    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.678Z",
    "source": "similarweb",
    "start_date": "string"
  }
}

Znormalizowana pomyślna odpowiedź

Website Top Geographies