Felo API PlatformFelo API Platform
Tutti gli endpoint di Similarweb
v0.2.0-beta
OpenAPI 3.1.0

Geografia principale del sito web

Server:https://openapi.felo.ai
Librerie client

Website Analytics

​

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

Geografia principale del sito web

​

Paesi principali per quota di traffico di un dominio per l'ultimo mese disponibile (data.countries, fino a 10 righe con country_code, country_name, share e visits). La copertura geografica è mondiale (ww) e fissa: un parametro country non è accettato per questo endpoint.

Riferimento prezzi

  • Misurazione: numero di risultati misurato.
  • Stima di riferimento per richiesta: USD 2.25.
  • 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 garantito o un limite di spesa. I crediti delle risorse non sono crediti Felo. Gli addebiti finali seguono le registrazioni di fatturazione Felo.

Parametri di query
  • domain
    Tipo: string
    obbligatorio

    Nome host del sito web semplice, senza schema, percorso, porta o credenziali.

  • month
    Tipo: string

    Mese completo in YYYY-MM. Predefinito al mese UTC completo precedente.

Risposte
  • 200
    Tipo: object

    Risposta riuscita normalizzata

    • data
      Tipo: object
      obbligatorio
      • countries
        Tipo: array object[] 1…10
        obbligatorio
        • country_code
          Tipo: string
          obbligatorio
        • country_name
          Tipo: string
          obbligatorio
        • rank
          Tipo: number | null
          obbligatorio
        • share
          Tipo: number | null
          obbligatorio
        • visits
          Tipo: number | null
          obbligatorio
    • meta
      Tipo: object
      obbligatorio
      • country
        enum
        const:  
        ww
        obbligatorio
        valori
        • ww
      • end_date
        Tipo: string
        obbligatorio
      • granularity
        const:  
        monthly
        obbligatorio
      • request_id
        Tipo: string
        obbligatorio
      • retrieved_at
        Tipo: string Formato: date-time
        obbligatorio

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

      • source
        const:  
        similarweb
        obbligatorio
      • start_date
        Tipo: string
        obbligatorio
    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-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"
  }
}
Website Top Geographies