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

Ruch i zaangażowanie

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

Ruch i zaangażowanie

​

Ruch i zaangażowanie. Odpowiedź jest zgodna z kopertą SimilarWeb v5 (meta + data). Ograniczenie dat: zakres start_date–end_date musi obejmować od 1 do 120 miesięcznych przedziałów.

Cennik referencyjny

  • Rozliczanie: jednostki zasobów planu.
  • Szacunek referencyjny dla żądania: USD 0.075.
  • Podstawa kosztu jednostkowego: USD 0.075.
  • Jednostka zasobu: similarweb_credit.
  • Referencyjny mnożnik klienta: 1.0. Nie stosuj go ponownie do rozliczonej kwoty klienta.
  • Podstawy kosztu nie ustalają ostatecznej ceny dla klienta, również 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
  • country
    enum
    const:  
    ww

    Wyłącznie dane ogólnoświatowe; wartości nie rozróżniają wielkości liter.

    wartości
    • ww
  • domain
    Typ: string
    min. długość:  
    1
    maks. długość:  
    253
    wymagane
  • end_date
    Typ: string
    wymagane
  • granularity
    enum
    const:  
    monthly
    wartości
    • monthly
  • main_domain_only
    Typ: boolean
  • metrics
    Typ: string
    wymagane

    Separator elementów: ,. Maksymalnie 8 elementów rozdzielonych separatorem. Co najmniej 1 element rozdzielony separatorem.

  • mtd
    Typ: boolean
  • start_date
    Typ: string
    wymagane
  • web_source
    Typ: string enum
    wartości
    • desktop
    • mobile_web
    • total
Odpowiedzi
  • 200
    Typ: object

    Koperta SimilarWeb v5 (meta + data).

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

        Średni czas na witrynie (w sekundach)

      • bounce_rate
        Typ: number | null Format: double

        Odsetek wizyt, w których wyświetlono tylko jedną stronę witryny

      • date
        Typ: string
      • new_users
        Typ: number | null Format: double

        Szacowana liczba nowych użytkowników witryny

      • page_views
        Typ: number | null Format: double

        Szacowana liczba odsłon witryny

      • pages_per_visit
        Typ: number | null Format: double

        Średnia liczba odsłon na wizytę

      • returning_users
        Typ: number | null Format: double

        Szacowana liczba powracających użytkowników witryny

      • unique_visitors
        Typ: number | null Format: double

        Szacowana liczba unikalnych odwiedzających witrynę (bez deduplikacji między urządzeniami)

      • visits
        Typ: number | null Format: double

        Szacowana liczba wizyt w witrynie

    • meta
      Typ: object · ResponseE0D24A93E9A2_SimilarWebMeta

      Metadane koperty odpowiedzi SimilarWeb v5.

      • status
        Typ: string
        wymagane

        Status upstream; 'success' przy udanym wywołaniu.

      • last_updated
        Typ: string

        Data najnowszego punktu danych dostępnego upstream (YYYY-MM-DD).

      • query
        Typ: object

        Echo paginacji/sortowania, gdy ma zastosowanie (limit, offset, asc, sort).

      • request
        Typ: object

        Pełne echo znormalizowanego żądania upstream (parametry w postaci otrzymanej).

    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/traffic-engagement
curl 'https://openapi.felo.ai/v1/beta/similarweb/website/traffic-engagement?domain=cnn.com&end_date=2026-09&metrics=visits&start_date=2026-09' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "meta": {
    "status": "success",
    "last_updated": "2026-06-30",
    "request": {},
    "query": {}
  },
  "data": [
    {
      "date": "string",
      "visits": null,
      "bounce_rate": null,
      "average_visit_duration": null,
      "pages_per_visit": null,
      "page_views": null,
      "unique_visitors": null,
      "new_users": null,
      "returning_users": null
    }
  ]
}

Koperta SimilarWeb v5 (meta + data).

Traffic & Engagement