# Fandom API

> Create YouTube-audience campaigns, audiences, data stores and targeting from your own code or AI apps.

- [Fandom API](https://docs.fandom.ai/index.md): Build YouTube-audience campaigns from your own code or AI apps.
- [Quickstart](https://docs.fandom.ai/quickstart.md): Your first call in two minutes.
- [Authentication](https://docs.fandom.ai/authentication.md): API keys, scopes and safe retries.
- [Errors and limits](https://docs.fandom.ai/errors.md): Error format, rate limits and pages.
- [Build a campaign](https://docs.fandom.ai/guides/campaign.md): From a brand to a paused Google Ads campaign, in six calls.
- [Explore an audience](https://docs.fandom.ai/guides/exploration.md): See which channels an audience also watches, and how they group.
- [Use Fandom from AI apps](https://docs.fandom.ai/mcp.md): Connect Claude, ChatGPT, Cursor and other MCP clients.
- [Get the workspace](https://docs.fandom.ai/api-reference/workspace/get-the-workspace.md): The workspace this key belongs to: counts and the most recent campaigns. A good first call.
- [Search the workspace](https://docs.fandom.ai/api-reference/workspace/search-the-workspace.md): Find campaigns, audiences, data stores and brands by name in one call.
- [List campaigns](https://docs.fandom.ai/api-reference/campaigns/list-campaigns.md): Newest first.
- [Create a campaign](https://docs.fandom.ai/api-reference/campaigns/create-a-campaign.md): Creates the campaign exactly as the app's New campaign form does. Audiences you pass are attached and start generating targeting right away. Nothing is sent to Google Ads.
- [Get a campaign](https://docs.fandom.ai/api-reference/campaigns/get-a-campaign.md): One campaign, with its audiences and Google Ads link.
- [Delete a campaign](https://docs.fandom.ai/api-reference/campaigns/delete-a-campaign.md): Removes it from Fandom. A linked Google Ads campaign is not touched.
- [Update a campaign](https://docs.fandom.ai/api-reference/campaigns/update-a-campaign.md): Send only the fields to change. Google Ads settings are saved in Fandom; a campaign already in Google Ads picks them up on its next sync from the app.
- [Add an audience to a campaign](https://docs.fandom.ai/api-reference/campaigns/add-an-audience-to-a-campaign.md): Attaches a saved audience and, by default, starts generating its targeting.
- [Get targeting](https://docs.fandom.ai/api-reference/targeting/get-targeting.md): Each audience's keywords, segments, topics and websites. Everything listed is in the campaign's targeting and goes to Google Ads on the next sync.
- [Add or remove targeting](https://docs.fandom.ai/api-reference/targeting/add-or-remove-targeting.md): The app's Add and Delete for one audience. Removed terms come out of Google Ads on the next sync. Not allowed while the audience is generating.
- [Generate targeting](https://docs.fandom.ai/api-reference/targeting/generate-targeting.md): Starts generating in the background. With no `audienceIds`, generates every audience that has none yet; naming an audience regenerates it. Audiences need data stores. Poll Get targeting until `ready`.
- [List Google Ads accounts](https://docs.fandom.ai/api-reference/google-ads/list-google-ads-accounts.md): The workspace's connected Google Ads accounts.
- [Get performance](https://docs.fandom.ai/api-reference/google-ads/get-performance.md): Impressions, clicks, cost and conversions for the Fandom campaigns in one account.
- [Create in Google Ads](https://docs.fandom.ai/api-reference/google-ads/create-in-google-ads.md): Creates the campaign in Google Ads, paused, exactly as the campaign page does. Nothing spends until someone turns it on in Google Ads. Targeting goes over when the app syncs.
- [List audiences](https://docs.fandom.ai/api-reference/audiences/list-audiences.md): Saved audiences, newest first.
- [Create an audience](https://docs.fandom.ai/api-reference/audiences/create-an-audience.md): Names must be unique in the workspace. Link data stores so targeting has real data behind it.
- [Get an audience](https://docs.fandom.ai/api-reference/audiences/get-an-audience.md): One saved audience.
- [Delete an audience](https://docs.fandom.ai/api-reference/audiences/delete-an-audience.md): Removes it from the workspace. Campaigns that use it keep their copy.
- [Update an audience](https://docs.fandom.ai/api-reference/audiences/update-an-audience.md): Send only the fields to change. Lists replace the stored list. Campaigns keep the copy they attached.
- [List data stores](https://docs.fandom.ai/api-reference/data-stores/list-data-stores.md): The workspace's data stores, newest first.
- [Create a data store](https://docs.fandom.ai/api-reference/data-stores/create-a-data-store.md): Collects YouTube channels and videos, with their comments, in the background. Starts as `collecting`; poll Get a data store until `ready`.
- [Get a data store](https://docs.fandom.ai/api-reference/data-stores/get-a-data-store.md): Check `status` to see when collection is done.
- [Delete a data store](https://docs.fandom.ai/api-reference/data-stores/delete-a-data-store.md): Removes it from the workspace. Library stores can't be deleted.
- [Rename a data store](https://docs.fandom.ai/api-reference/data-stores/rename-a-data-store.md): Library stores can't be changed.
- [List brands](https://docs.fandom.ai/api-reference/brands/list-brands.md): Newest first.
- [Create a brand](https://docs.fandom.ai/api-reference/brands/create-a-brand.md): Campaigns created with this brand inherit its name, website and description.
- [Get a brand](https://docs.fandom.ai/api-reference/brands/get-a-brand.md): One brand and how many campaigns use it.
- [Delete a brand](https://docs.fandom.ai/api-reference/brands/delete-a-brand.md): Removes it from the workspace. Its campaigns stay.
- [Update a brand](https://docs.fandom.ai/api-reference/brands/update-a-brand.md): Send only the fields to change. Existing campaigns keep the brand details they were created with.
- [Search YouTube audiences](https://docs.fandom.ai/api-reference/audience-exploration/search-youtube-audiences.md): Find a starting point for a map: channels by name, channels whose audiences talk about your words, topics, and saved audiences.
- [Map an audience](https://docs.fandom.ai/api-reference/audience-exploration/map-an-audience.md): The channels an audience also watches, grouped by shared commenters, with people counts. Built from real YouTube comment data; takes a few seconds the first time.
- [Get a YouTube channel](https://docs.fandom.ai/api-reference/audience-exploration/get-a-youtube-channel.md): What a channel makes, its topics and its latest videos.

## OpenAPI Specs

- [openapi](/api-reference/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.