# Sumber Saluran Pemasaran

**API:** Data API

**Endpoint:** `GET /v1/beta/similarweb/website/marketing-channel-sources-legacy`

**Tags:** Website Analytics

Sumber Saluran Pemasaran. Respons mengikut sampul SimilarWeb v5 (meta + data). Kekangan tarikh: julat start_date-end_date mesti merangkumi antara 1 dan 120 kumpulan data bulanan.

### Rujukan harga

- Pemeteran: Unit sumber pelan.
- Anggaran rujukan setiap permintaan: USD 0.525.
- Asas kos unit: USD 0.075.
- Unit sumber: `similarweb_credit`.
- Pengganda pelanggan rujukan: 1.0. Jangan gunakan semula pada amaun pelanggan yang telah diselesaikan.
- Asas kos tidak menentukan harga pelanggan akhir, termasuk apabila sifar.

Metadata rujukan sahaja, bukan sebut harga akaun, harga terjamin atau had perbelanjaan. Kredit sumber bukan kredit Felo. Caj akhir mengikut rekod pengebilan 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", default: "monthly" |  |
| `main_domain_only` | query | no | boolean, default: true |  |
| `start_date` | query | yes | string |  |
| `web_source` | query | no | string, enum: "desktop", "mobile_web", "total" |  |

## Responses

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

Headers:
- `X-Request-Id` (string) — Pengecam permintaan untuk disertakan semasa menghubungi sokongan Felo.

**application/json**

Schema: object

```json
{
  "type": "object",
  "properties": {
    "meta": {
      "$ref": "#/components/schemas/Response80775Eb82C8B_SimilarWebMeta"
    },
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string"
          },
          "source_type": {
            "type": [
              "string",
              "null"
            ]
          },
          "visits": {
            "type": [
              "number",
              "null"
            ],
            "format": "double",
            "description": "Anggaran bilangan lawatan ke laman web"
          },
          "bounce_rate": {
            "type": [
              "string",
              "null"
            ]
          },
          "average_visit_duration": {
            "type": [
              "string",
              "null"
            ]
          },
          "pages_per_visit": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      }
    }
  }
}
```

### 400 — Permintaan tidak dapat diproses. Semak parameter permintaan.

### 401 — Kunci API Felo yang sah diperlukan.

### 402 — Permintaan tidak dapat diteruskan kerana keperluan pengebilan tidak dipenuhi.

### 403 — Akaun tidak dibenarkan melakukan operasi ini.

### 429 — Had permintaan atau had perbelanjaan telah dicapai.

### 502 — Perkhidmatan tidak dapat menyelesaikan permintaan.

### 503 — API atau perkhidmatan pengebilan tidak tersedia buat sementara waktu.

### 504 — Perkhidmatan tamat masa semasa memproses permintaan.

### default — Respons ralat; respons passthrough huluan mungkin menggunakan format penyedia

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response80775Eb82C8B_SimilarWebMeta

`#/components/schemas/Response80775Eb82C8B_SimilarWebMeta`

```json
{
  "type": "object",
  "description": "Metadata envelope respons SimilarWeb v5.",
  "properties": {
    "status": {
      "type": "string",
      "description": "Status huluan; 'success' apabila panggilan berjaya.",
      "example": "success"
    },
    "last_updated": {
      "type": "string",
      "description": "Tarikh titik data terbaharu yang tersedia di huluan (YYYY-MM-DD).",
      "example": "2026-06-30"
    },
    "request": {
      "type": "object",
      "description": "Gema penuh permintaan huluan yang dinormalkan (parameter seperti diterima)."
    },
    "query": {
      "type": "object",
      "description": "Gema penomboran/pengisihan apabila berkenaan (limit, offset, asc, sort)."
    }
  },
  "required": [
    "status"
  ]
}
```
