# Références

**API:** Data API

**Endpoint:** `GET /v1/beta/similarweb/website/referrals`

**Tags:** Website Analytics

Références. La réponse suit l'enveloppe SimilarWeb v5 (meta + data).

### Référence tarifaire

- Mesure : nombre de résultats mesurés.
- Estimation de référence par requête : USD 0.3.
- Base de coût unitaire : USD 0.075.
- Unité de ressource : `similarweb_credit`.
- Multiplicateur client de référence : 1.0. Ne pas l'appliquer à nouveau à un montant client déjà réglé.
- Les bases de coût ne déterminent pas le prix client final, y compris lorsqu'elles valent zéro.

Métadonnées de référence uniquement, et non un devis de compte, un prix garanti ou un plafond de dépenses. Les crédits de ressources ne sont pas des crédits Felo. Les débits définitifs suivent les enregistrements de facturation 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 |  |
| `end_date` | query | yes | string |  |
| `granularity` | query | no | string, enum: "monthly" |  |
| `limit` | query | yes | integer |  |
| `main_domain_only` | query | no | boolean |  |
| `offset` | query | no | integer |  |
| `start_date` | query | yes | string |  |
| `traffic_source` | query | no | string |  |
| `web_source` | query | no | string, enum: "desktop", "mobile_web", "total" |  |

## Responses

### 200 — Enveloppe SimilarWeb v5 (meta + data).

Headers:
- `X-Request-Id` (string) — Identifiant de requête à inclure lorsque vous contactez le support Felo.

**application/json**

Schema: object

```json
{
  "type": "object",
  "properties": {
    "meta": {
      "$ref": "#/components/schemas/Response758Fcfa4290B_SimilarWebMeta"
    },
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "domain": {
            "type": "string"
          },
          "share": {
            "type": "number"
          },
          "change": {
            "type": "number"
          },
          "visits": {
            "type": "number"
          }
        }
      }
    }
  }
}
```

### 400 — La requête n'a pas pu être traitée. Vérifiez les paramètres de la requête.

### 401 — Une clé API Felo valide est requise.

### 402 — La requête ne peut pas aboutir car une condition de facturation n'est pas remplie.

### 403 — Le compte n'est pas autorisé à effectuer cette opération.

### 429 — Une limite de requêtes ou de dépenses a été atteinte.

### 502 — Le service n'a pas pu terminer la requête.

### 503 — L'API ou le service de facturation est temporairement indisponible.

### 504 — Le service a expiré lors du traitement de la requête.

### default — Réponse d'erreur ; les réponses transmises depuis l'upstream peuvent utiliser les formats du fournisseur

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response758Fcfa4290B_SimilarWebMeta

`#/components/schemas/Response758Fcfa4290B_SimilarWebMeta`

```json
{
  "type": "object",
  "description": "Métadonnées de l'enveloppe de réponse SimilarWeb v5.",
  "properties": {
    "status": {
      "type": "string",
      "description": "Statut en amont ; 'success' lors d'un appel réussi.",
      "example": "success"
    },
    "last_updated": {
      "type": "string",
      "description": "Date du point de données le plus récent disponible en amont (YYYY-MM-DD).",
      "example": "2026-06-30"
    },
    "request": {
      "type": "object",
      "description": "Écho complet de la requête normalisée en amont (paramètres tels que reçus)."
    },
    "query": {
      "type": "object",
      "description": "Écho de pagination/tri le cas échéant (limit, offset, asc, sort)."
    }
  },
  "required": [
    "status"
  ]
}
```
