# Building a Natural Language Interface to the Spotify Ads API Manage Spotify ad campaigns effortlessly with Claude Code plugin. - **Source:** [Spotify Engineering](https://engineering.atspotify.com) - **Published:** 2026-05-01 - **Topic:** [Data & AI](https://brifing.si/c/data-ai) - **Original article:** - **On Brifing:** https://brifing.si/s/4edb9210-45b5-4de9-a377-9adbbfb862e6 ## Introduction A Claude Code plugin was developed to make the Spotify Ads API more accessible. This plugin allows users to create ad campaigns by making requests in natural language, simplifying complex API calls into straightforward instructions. ## API Complexity The Spotify Ads API v3 includes over 30 resource types, nested targeting structures, and multi-step entity hierarchies. This complexity poses a significant barrier, especially for those looking to launch a simple audio campaign. ## Natural Language Solution The plugin converts user requests in natural language into Spotify Ads API calls. For example, a request like 'Create an audio campaign targeting 25-44 year olds in the US' is automatically transformed into the correct API calls. ## Plugin Structure The plugin consists of Markdown files, a bash script, and two small Python helpers. This structure allows developers and advertisers to fully control how LLMs interact with the Ads API. ## Advantages of Claude Code Claude Code's plugin system offers a critical feature for this project: plugins are written in Markdown. This provides a system that is human-readable and modifiable without compiled code. ## CLI and OpenAPI Choice The plugin uses a CLI-first approach and OpenAPI specification. This allows users to see and control every API call. Additionally, the OpenAPI specification serves as the source of truth for the API. ## Transparency and Auditability The plugin shows every API call it makes to the user. This transparency provides user control in an advertising system where every request can impact real budgets. ## Natural Language Agent The natural language agent turns the LLM into a Spotify Ads API specialist. This agent automatically performs tasks like converting dollars to micro-units and describing dates. ## Developer Tools The plugin offers valuable insights into building developer tools on top of LLM-powered agents, providing useful information for similar projects. ## Conclusion This plugin significantly reduces the workload for advertisers and developers by simplifying the use of the Spotify Ads API. The natural language interface enhances user experience by simplifying complex API calls. ## Sources covering this story - https://engineering.atspotify.com/2026/5/spotify-ads-api-claude-plugins/ — --- _Summary written by Brifing from the original reporting. Copyright in the original article belongs to its publisher; read the full piece at the link above._