# Walnut Customer Data API

**Canonical:** https://apis.io/apis/walnut/walnut-api/  
**Provider:** Walnut — https://apis.io/providers/walnut/  
**Base URL:** https://customer-api.teamwalnut.com  
**Documentation:** https://help.walnut.io/help/api

Walnut Customer Data API is published by [Walnut](https://apis.io/providers/walnut/) on the [APIs.io](https://apis.io/) network. Tagged areas include Sales Demo, Interactive Demos, Analytics, and Personalization. The published artifact set on APIs.io includes API documentation, an API reference, a getting-started guide, authentication docs, rate-limit docs, and pricing.

Read-only REST API for Walnut demo analytics. Two data endpoints plus a health check — GET /demo-sessions returns individual demo-session records across 29 documented fields with filtering, offset pagination, comma-separated field selection and multi-dimensional group_by aggregation, and GET /demo-sessions/summary returns a pre-built snapshot of totals, averages, top demos and top countries. Authenticated with a static x-api-key header issued by a Walnut account representative. Available on the Scale (enterprise) plan only. Walnut publishes no OpenAPI document for it.

## Machine-readable artifacts (17)

- **Documentation** — https://help.walnut.io/help/api
- **APIReference** — https://help.walnut.io/help/api/customer-data-api
- **GettingStarted** — https://help.walnut.io/help/api/quick-start
- **CodeSamples** — https://help.walnut.io/help/api/code-samples
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/walnut/refs/heads/main/authentication/walnut-authentication.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/walnut/refs/heads/main/conventions/walnut-conventions.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/walnut/refs/heads/main/errors/walnut-problem-types.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/walnut/refs/heads/main/data-model/walnut-data-model.yml
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/walnut/refs/heads/main/rate-limits/walnut-rate-limits.yml
- **Lifecycle** — https://raw.githubusercontent.com/api-evangelist/walnut/refs/heads/main/lifecycle/walnut-lifecycle.yml
- **Sandbox** — https://raw.githubusercontent.com/api-evangelist/walnut/refs/heads/main/sandbox/walnut-sandbox.yml
- **MCPServer** — https://raw.githubusercontent.com/api-evangelist/walnut/refs/heads/main/mcp/walnut-mcp.yml
- **ToolCrosswalk** — https://raw.githubusercontent.com/api-evangelist/walnut/refs/heads/main/mcp/walnut-tool-crosswalk.yml
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/walnut/refs/heads/main/asyncapi/walnut-webhooks.yml
- **LLMsTxt** — https://raw.githubusercontent.com/api-evangelist/walnut/refs/heads/main/llms/walnut-docs-llms.txt
- **Pricing** — https://www.walnut.io/pricing
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/walnut/refs/heads/main/apis.yml

## Tags

Sales Demo, Interactive Demos, Analytics, Personalization

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/walnut/walnut-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/walnut/.