Profound customers can now build any chart, KPI, or table using Profound data from public API calls, without piecing together which endpoints to hit, which parameters they take, and which gotchas will trip them up on the way. The Cookbook is the layer on top of our REST reference: a set of end-to-end recipes that take you from "I want this number" to runnable code.
What the Profound Cookbook is
The REST API reference tells you what every endpoint does. The Profound Cookbook tells you what to build with them.
Each recipe maps directly to something you already see in the Profound dashboard, including Visibility Score, Citation Share, the leaderboards, and the period-over-period delta on a KPI tile. Every recipe walks through the exact call (or chain of calls) that produces it, and ships with runnable Python and curl side by side so you can copy whichever fits your stack.
There are also a handful of conventions that catch nearly every new integrator on day one. These come up in every recipe, so we put them up front in one place.
What's inside
The Profound Cookbook is currently organized into three sections.
Setup. Find your category ID, list your owned assets and domains, and skim the full endpoint reference on one scannable page. This is the five-minute onboarding that builds the foundation for every recipe that follows.
Visibility. Recipes covering the Visibility surface, including a single asset's score for a window with its delta, the daily, weekly, and monthly time series, the top leaderboard for a category, multi-line competitor comparisons, and segmenting one asset's score by model, region, or persona.
Citations. Recipes covering the Citations surface, including owned-domain Citation Share with the period delta, the daily share-and-volume time series from a single call, and the full Citation Rank leaderboard with per-domain percentage point changes.
This is the starting set, not the ceiling. The Cookbook is a living surface that we're maintaining actively and expanding as the public API grows, so expect the library to keep adding recipes alongside what you can build.
Designed for the AI assistant in your IDE
Most Profound customers are building API integrations with Claude, ChatGPT, or Cursor at their side. We wrote every recipe with that in mind.
The full docs site is available as a flat index here. Paste that URL into your assistant and it can fetch any page on demand. Each recipe is self-contained and copy-pasteable, so you can drop one into a conversation and your assistant has everything it needs to adapt it to your use case.
How Profound customers can use this
Pull Profound metrics into your BI stack
Send Visibility Score, Share of Voice, and Citation Rank into Looker, Tableau, Mode, or a Hex notebook on a schedule. Once a recipe is wired up, the data flows wherever your team already reports from.
Build internal dashboards and KPI tiles
Embed live Profound metrics into the internal apps your team already uses. Use the period-over-period delta recipes to drive KPI tiles, and the time-series recipes to power trended charts.
Automate weekly and monthly reporting
Replace the manual pull-and-paste cycle with a script. Recipes for time series, leaderboards, and competitor comparisons give you everything you need to produce a repeatable reporting workflow.
Power custom alerts and workflows
Run any recipe on a schedule and pipe the output into Slack, email, or your internal alerting system. Get notified when a competitor's Visibility Score crosses a threshold, when a key domain drops off the Citation Rank leaderboard, or when your Share of Voice shifts in a region you care about.
Get started
The Profound Cookbook is live today. With a Profound API key, you can be pulling your first Visibility Score in under five minutes.
If you're not yet a Profound customer and want to see what's possible, connect with our team here.
