What is the Spark API?
The Spark API is a lightweight way to programmatically query GWI’s insight engine. It allows:- Natural-language style queries to surface summarized audience insights
- Fast access to curate, contextualized insight summaries across geographies, demographics, and behaviors
- A bridge between human questions and GWI’s structured data, without needing to manage variables or wave logic
Use cases
- Power an internal tool or bot that returns audience insights on demand
- Enable content teams to retrieve stats and summaries for decks or briefs
- Build a simple interface for sales and marketings teams to explore audience attributes
- Automate recurring queries for campaign planning, copywriting, or persona building
Key features
- REST API for querying pre-processed, summarised insights
- Natural language or keyword-based querying (e.g. “Gen Z in the UK”)
- Returns insight text + metadata (e.g., audience matched, underlying data)
Outputs
- JSON object with a set of 5–6 summarised insights
- Includes references to audience segments, confidence scores, and sources
- Supports caching for repeated queries