> For the complete documentation index, see [llms.txt](https://docs.cookie3.com/cookie3-analytics/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cookie3.com/cookie3-analytics/api/referral-systems/api-response-schema.md).

# API Response schema

### Interpreting the API Response

```json
[
  {
    "primaryDimension": "Referral",
    "secondaryDimension": "uniqueReferrerID",
    "totalVisitsCount": 150,
    "totalVisitorsCount": 140,
    "newVisitorsCount": 100,
    "uniqueWalletsCount": 80,
    "web3VisitorsCount": 70,
    "engagedVisitsCount": 120,
    "engagementRate": 0.8,
    "engagedVisitsRate": 0.75,
    "averageNumberOfPagesPerVisit": 3,
    "averageVisitDurationSeconds": 180,
    "totalEventsCount": 200,
    "conversionsCount": 50,
    "visitorsWithConversionCount": 45,
    "averageConversionsCountByVisitor": 1.1,
    "conversionsUsdValue": 5000
  }
]
```

### Metrics Explained:

* **`totalVisitsCount`**: Total number of visits from the referrer.
* **`newVisitorsCount`**: Number of first-time visitors.
* **`engagementRate`**: Proportion of engaged visits
* **`conversionsCount`**: Total number of conversions
* **`conversionsUsdValue`**: Monetary value of conversions

## Utilizing the Data

Use this data to:

* Identify top-performing referrers. 
* Calculate conversion rates per referrer. 
* Optimize marketing strategies based on performance.