Welcome to the Future Demand Developer Kit. This documentation is for partner engineering teams who want to embed Lookout and Wave — two products from our Audience Intelligence platform — into their own web application. If you follow the integration guides linked below, a small team should be able to ship a working integration in a few days.

​
What you can build

Lookout

Surface event-level demand insights and recommendations to your users: which events to focus on, expected demand curves, simulation of pricing or marketing actions, and a portfolio dashboard.

Wave

Build, launch, and measure activation campaigns: setup wizard with taste-cluster targeting, publish to Meta, edit-while-running, and attribution reporting.

Affinity

Personal product and event recommendations for your website and app — “recommended for you”, “you might also like”, personalised landing pages. Its own service, its own credential.

Quickstart

Authenticate and make your first real call in under 10 minutes, then branch into the integration guides.
The full OpenAPI surface is in the API Reference tab in the top navigation — use it as the canonical endpoint reference once you understand the call chains.

​
Where to start

1

Read the platform model

The Platform Model explains the partner → client → event hierarchy. Every API call lives somewhere in this tree; once it clicks, the rest of the API makes immediate sense.
2

Run the quickstart

Quickstart gets you authenticated and making your first real call in under 10 minutes.
3

Pick an integration guide

Open the Lookout or Wave overview and work through one feature end-to-end. Each guide is self-contained: screenshot, call chain, copy-pasteable code, gotchas.
4

Lift the TypeScript client

The TypeScript Client is a thin, generated wrapper around the OpenAPI spec. Drop it into your project to skip the boilerplate.

​
How this documentation is organised

  • Getting Started — auth, environments, your first call.
  • Core Concepts — the mental model behind the API. Read this once.
  • Integration Guides — one page per feature, mirroring the screens in the reference Future Demand webapp. This is where the value is.
  • Cookbook — recipes for cross-cutting concerns: pagination, polling, uploads, errors, rate limits.
  • SDK & Snippets — TypeScript client and React hooks you can use directly.
  • API Reference — auto-generated from the OpenAPI spec.

​
Conventions

Product names are capitalised: Lookout, Wave, and Affinity. We refer to the whole platform as Future Demand. (The wider product suite includes Backhaul and Sentinel — those are not covered in this developer kit.)
Every request example assumes:
  • Base URL: https://client-api.prd.future-demand.com/api/v3 (production) — see Environments.
  • Auth via API key in the apikey header — see Authentication.
  • Responses are JSON unless otherwise noted; timestamps are ISO 8601 UTC.

​
Getting help