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

Ranking najpopularniejszych witryn Similarweb

Serwer:https://openapi.felo.ai
Biblioteki klienckie

Website Analytics

​

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

Ranking najpopularniejszych witryn Similarweb

​

Zwraca rankingi witryn dla kategorii branżowej. category i limit są wymagane. limit musi mieścić się w zakresie od 1 do 20. country obsługuje wyłącznie dane ogólnoświatowe (ww) i domyślnie przyjmuje wartość ww. offset kontroluje paginację. Odpowiedź zawiera meta i data.

Cennik referencyjny

  • Rozliczanie: liczba naliczonych wyników.
  • 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
  • category
    Typ: string
    min. długość:  
    1
    maks. długość:  
    191
    wymagane
  • country
    enum
    const:  
    ww

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

    wartości
    • ww
  • limit
    Typ: integer
    min.:  
    1
    maks.:  
    20
    wymagane

    Integer numbers.

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

    Integer numbers.

Odpowiedzi
  • 200
    Typ: object

    Koperta SimilarWeb v5 (meta + data).

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

        Integer numbers.

    • meta
      Typ: object · ResponseC6C9032778Bd_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/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