# Istantanea del traffico del sito web

**API:** Data API

**Endpoint:** `GET /v1/beta/similarweb/website-traffic-snapshot`

**Tags:** Website Analytics

Istantanea del traffico dell'ultimo mese per un dominio: visite più le metriche di engagement principali (durata media della visita, frequenza di rimbalzo, pagine per visita) in un unico oggetto. Il mese più recente disponibile viene selezionato automaticamente e riportato in meta.start_date / meta.end_date.

### Riferimento prezzi

- Misurazione: unità di risorsa del piano.
- Stima di riferimento per richiesta: USD 0.3.
- 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.

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `country` | query | no | string, enum: "ww", default: "ww" |  |
| `domain` | query | yes | string |  |
| `month` | query | no | string |  |

## Responses

### 200 — Risposta riuscita normalizzata

Headers:
- `X-Request-Id` (string) — Identificatore della richiesta da includere quando contatti l'assistenza Felo.

**application/json**

Schema: object

```json
{
  "additionalProperties": false,
  "properties": {
    "data": {
      "additionalProperties": false,
      "properties": {
        "domain": {
          "type": "string"
        },
        "metrics": {
          "additionalProperties": false,
          "properties": {
            "average_visit_duration": {
              "type": [
                "number",
                "null"
              ]
            },
            "bounce_rate": {
              "type": [
                "number",
                "null"
              ]
            },
            "pages_per_visit": {
              "type": [
                "number",
                "null"
              ]
            },
            "visits": {
              "type": [
                "number",
                "null"
              ]
            }
          },
          "required": [
            "average_visit_duration",
            "bounce_rate",
            "pages_per_visit",
            "visits"
          ],
          "type": "object"
        },
        "month": {
          "pattern": "^[0-9]{4}-[0-9]{2}$",
          "type": "string"
        }
      },
      "required": [
        "domain",
        "month",
        "metrics"
      ],
      "type": "object"
    },
    "meta": {
      "additionalProperties": false,
      "properties": {
        "country": {
          "enum": [
            "ww"
          ],
          "type": "string"
        },
        "end_date": {
          "pattern": "^[0-9]{4}-[0-9]{2}$",
          "type": "string"
        },
        "granularity": {
          "const": "monthly",
          "type": "string"
        },
        "request_id": {
          "type": "string"
        },
        "retrieved_at": {
          "format": "date-time",
          "type": "string"
        },
        "source": {
          "const": "similarweb",
          "type": "string"
        },
        "start_date": {
          "pattern": "^[0-9]{4}-[0-9]{2}$",
          "type": "string"
        }
      },
      "required": [
        "source",
        "request_id",
        "retrieved_at",
        "country",
        "granularity",
        "start_date",
        "end_date"
      ],
      "type": "object"
    }
  },
  "required": [
    "data",
    "meta"
  ],
  "type": "object"
}
```

### 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**

Schema:

```json
{}
```
