Felo API PlatformFelo API Platform
Tutti gli endpoint di Similarweb
v0.2.0-beta
OpenAPI 3.1.0
Server:https://openapi.felo.ai
Librerie client

Website Analytics

​

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

Siti simili

​

Siti simili. La risposta segue l'envelope SimilarWeb v5 (meta + data). Intervallo temporale (vincolo upstream di SimilarWeb): start_date ed end_date devono coprire ESATTAMENTE 3 mesi consecutivi; un intervallo di 1 o 2 mesi viene rifiutato con l'errore upstream 120 ('must span exactly 3 month(s)'). L'intervallo deve anche essere la finestra più recente supportata da SimilarWeb, che avanza ogni mese; un intervallo più vecchio o fuori intervallo viene rifiutato con l'errore 101 ('Dates not in range'). In pratica, richiedi i tre mesi completi più recenti (ad esempio, se l'ultimo mese pubblicato è 2026-07, usa start_date=2026-05 ed end_date=2026-07). Per leggere l'esatto intervallo attualmente supportato, chiama l'endpoint /describe di SimilarWeb per questa API.

Riferimento prezzi

  • Misurazione: numero di risultati misurato.
  • Stima di riferimento per richiesta: USD 0.375.
  • Base di costo unitario: USD 0.075.
  • Unità di risorsa: similarweb_credit.
  • Moltiplicatore di riferimento per il cliente: 1.0. Non applicarlo di nuovo a un importo già addebitato al cliente.
  • Le basi di costo non determinano il prezzo finale per il cliente, anche quando sono zero.

Solo metadati di riferimento, non un preventivo dell'account né un prezzo o un limite di spesa garantito. I crediti delle risorse non sono crediti Felo. Gli addebiti finali seguono le registrazioni di fatturazione Felo.

Parametri di query
  • country
    enum
    const:  
    ww

    Solo dati mondiali; i valori non distinguono maiuscole e minuscole.

    valori
    • ww
  • domain
    Tipo: string
    lunghezza minima:  
    1
    lunghezza massima:  
    253
    obbligatorio
  • end_date
    Tipo: string
    obbligatorio
  • granularity
    enum
    const:  
    monthly
    valori
    • monthly
  • limit
    Tipo: integer
    min:  
    1
    max:  
    20
    obbligatorio

    Integer numbers.

  • main_domain_only
    Tipo: boolean
  • offset
    Tipo: integer
    min:  
    0
    max:  
    100000

    Integer numbers.

  • start_date
    Tipo: string
    obbligatorio
  • traffic_source
    Tipo: string
  • web_source
    Tipo: string enum
    valori
    • desktop
    • mobile_web
    • total
Risposte
  • 200
    Tipo: object

    Envelope SimilarWeb v5 (meta + data).

    • data
      Tipo: array object[]
      • affinity
        Tipo: number
      • category
        Tipo: string
      • domain
        Tipo: string
      • has_adsense
        Tipo: boolean
      • rank
        Tipo: integer

        Integer numbers.

    • meta
      Tipo: object · Response7B51F63Afd06_SimilarWebMeta

      Metadati dell'involucro della risposta SimilarWeb v5.

      • status
        Tipo: string
        obbligatorio

        Stato upstream; 'success' in caso di chiamata riuscita.

      • last_updated
        Tipo: string

        Data del punto dati più recente disponibile upstream (YYYY-MM-DD).

      • query
        Tipo: object

        Echo di paginazione/ordinamento quando applicabile (limit, offset, asc, sort).

      • request
        Tipo: object

        Echo completo della richiesta upstream normalizzata (parametri come ricevuti).

    application/json
  • 400

    Impossibile elaborare la richiesta. Controlla i parametri della richiesta.

  • 401

    È richiesta una chiave API Felo valida.

  • 402

    Impossibile procedere con la richiesta perché non è soddisfatto un requisito di fatturazione.

  • 403

    L'account non è autorizzato a eseguire questa operazione.

  • 429

    È stato raggiunto un limite di richieste o di spesa.

  • 502

    Il servizio non è riuscito a completare la richiesta.

  • 503

    L'API o il servizio di fatturazione è temporaneamente non disponibile.

  • 504

    Si è verificato un timeout durante l'elaborazione della richiesta.

  • default

    Risposta di errore; le risposte passthrough upstream possono usare formati del provider

    application/json
Request Example for get/v1/beta/similarweb/website/similar-sites
curl 'https://openapi.felo.ai/v1/beta/similarweb/website/similar-sites?domain=cnn.com&end_date=2026-09&limit=1&start_date=2026-07' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "meta": {
    "query": {
      "limit": 5,
      "offset": 0,
      "asc": null,
      "sort": null
    },
    "request": {
      "format": "json",
      "domain": "cnn.com",
      "granularity": "monthly",
      "start_date": "2026-05-01",
      "end_date": "2026-07-31",
      "metrics": [
        "rank",
        "affinity",
        "has_adsense"
      ],
      "category": null
    },
    "status": "success",
    "last_updated": "2026-07-31"
  },
  "data": [
    {
      "domain": "bbc.com",
      "category": "News_and_Media",
      "rank": 95,
      "affinity": 1,
      "has_adsense": true
    }
  ]
}
SimilarSites