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

Uczestnicy SERP — agregacja

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

Uczestnicy SERP — agregacja

​

Uczestnicy SERP — agregacja. Odpowiedź jest zgodna z kopertą SimilarWeb v5 (meta + data).

Cennik referencyjny

  • Rozliczanie: według liczby wyników.
  • Szacunek referencyjny dla żądania: USD 0.075.
  • 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
  • country
    enum
    const:  
    ww

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

    wartości
    • ww
  • end_date
    Typ: string
    wymagane
  • granularity
    enum
    const:  
    monthly
    wartości
    • monthly
  • keywords
    Typ: string
    wymagane

    Separator elementów: ,. Maksymalnie 1 rozdzielany element. Co najmniej 1 rozdzielany element.

  • limit
    Typ: integer
    min.:  
    1
    maks.:  
    20
    wymagane

    Integer numbers.

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

    Integer numbers.

  • start_date
    Typ: string
    wymagane
Odpowiedzi
  • 200
    Typ: object

    Koperta SimilarWeb v5 (meta + data).

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

        Suma kliknięć, które domena otrzymuje dla analizowanego słowa kluczowego

      • domain
        Typ: string | null

        Domena witryny bez 'www.' (np. 'example.com')

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

        Subdomena witryny bez 'www.' (np. 'developer.example.com')

      • top_url
        Typ: string | null

        Adres URL witryny z najwyższą pozycją organiczną dla analizowanego słowa kluczowego

      • top_url_position
        Typ: integer | null Format: int32

        Najwyższa najnowsza pozycja blended dla top_url w wybranym przedziale czasowym

      • traffic_share
        Typ: number | null Format: double

        Udział ruchu na witrynie

    • meta
      Typ: object · Response62E957Bfd704_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/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
    }
  ]
}

Koperta SimilarWeb v5 (meta + data).

SERP Players - Aggregated